ForHosting KIT · 日付・時間

2日付間カウントダウン

Q: サーバーの壁時計やJavaScriptのDateを使いますか？

いいえ。 両瞬間は入力文字列からです。エンジンはDate・ネット・乱数なしの純グレゴリオとオフセット演算で、結果は完全に決定的です。

2026年1月1日0時（UTC）から1月2日01:01:01までは1日1時間1分1秒、合計90061秒です。2つの日時と時差を入れると、カウントダウンの全体が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

開始のISO-8601日時: 2026-01-01T00:00:00Z
終了のISO-8601日時: 2026-01-02T01:01:01Z

結果

開始エポック秒: 1,767,225,600
終了エポック秒: 1,767,315,661
合計秒数: 90,061
日数: 1

イベント企画、製品ローンチページ、試験カウントダウン、SLAダッシュボードはみな同じ平明な答えを必要とします。既知の2瞬間のあいだに何日・何時間・何分・何秒あるかです。この2日付間カウントダウン計算機はISO-8601日時の組を受け取り、グレゴリオ規則で各民事日と時計欄を検証し、純整数演算で両側を絶対UTC秒に変換し、うるう年やタイムゾーンオフセットを再実装せずUIが描画できる構造化残量を返します。

fromとtoのISO日時の選び方と受け付ける形式

各値はISO-8601民事日時で、4桁の年・月・日、任意で時・分・秒の時刻が続きます。小数秒を付けてもよく、互換のため受理し、カウントダウン整数では整数秒に切り捨てます。末尾のZはUTCを意味し、プラスゼロ二コロンゼロゼロやマイナスゼロ五コロンゼロゼロのような数値オフセットは減算前にローカル欄を絶対UTCへずらします。

二千二十六ハイフンゼロ六ハイフン十五のような日付のみの値はUTCの真夜中として扱い、時刻を発明せず日境界が使えます。年は一から九千九百九十九、月は一から十二、日はその月に存在するもの（うるう年の2月29日を含む）に限ります。時は零から二十三、分と秒は零から五十九。

範囲外は黙って繰り上げず不正入力です。

主な使い道と実用上の限界

ローンチページ、結婚式タイマー、授業デモ、サポートスクリプトには、日付ライブラリやタイムゾーンDBを入れずにブラウザの無料2日付間カウントダウンを呼び出します。平日と祝日だけなら営業日カウンタと、先に民事欄を確かめてから完全タイムスタンプを組むなら月長ツールと組み合わせてください。

期待は正直に：本製品は明示オフセット適用後の2絶対瞬間間の経過民事時間を測り、通知の予定、公開祝日カレンダーの読込、壁時計の現在の発明はしません。入力の保持規則は他のKIT parse項目と同じです。

活用例

製品ローンチとマーケティングのカウントダウン

ランディングはfromをキャンペーン開始、toを公開に設定し、クライアント側の日付ライブラリなしで公開までの日・時・分・秒を描画します。

よくある質問

日時が不正な場合はどうなりますか？

悪いISO形、不可能な暦日、範囲外の時計欄は拒否され課金されません。

サーバーの壁時計やJavaScriptのDateを使いますか？

いいえ。両瞬間は入力文字列からです。エンジンはDate・ネット・乱数なしの純グレゴリオとオフセット演算で、結果は完全に決定的です。

終了日時が開始日時より前だとどうなりますか？

日・時・分・秒は正の数のままですが、合計秒数はマイナスになり、結果は過去として示されます。ページでは残りではなく期限切れと表示できます。

時刻なしで日付だけを入力できますか？

できます。日付だけの場合はその日のUTCの0時として扱うので、時刻を考えなくても日の区切りで計算できます。

タイムゾーンはどのように扱われますか？

時刻のあとにUTCを表すZ、または+02:00のような時差を付けます。2つの日時はUTCにそろえてから引き算するため、国をまたいでも正確な差になります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/date/countdown-between

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/date/countdown-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}'

const res = await fetch("https://api.kit.forhosting.com/date/countdown-between", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-02T01:01:01Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/countdown-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-02T01:01:01Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/countdown-between", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/countdown-between", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "from": "2026-01-01T00:00:00Z",
  "to": "2026-01-02T01:01:01Z"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.countdown_between",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

経路は壁時計・乱数・ネットワークに触れないため、同一のfromとtoは継続的インテグレーションでも本番でも常に同一のJSONになります。不正な形、2月30日のような不可能な日付、範囲外の時計成分はinvalid_inputで失敗し課金されません。

fromとtoのISO日時の選び方と受け付ける形式

fromとtoという2つの文字列フィールドを送ってください。別名start、begin、start_dateはfromへ、end、until、end_date、targetはtoへ対応し、一般的なフォームとAPIの命名に合わせます。両フィールド必須で、欠落・非文字列・空白のみは欠側を名指すinvalid_inputを起こします。

日・時・分・秒・total_secondsと方向の読み方

days、hours、minutes、secondsは常に非負で、その絶対値を再構成するため、1日1時間1分1秒の区間は方向に関係なくdays一、hours一、minutes一、seconds一になります。各段が純グレゴリオとオフセット演算なので、フィクスチャはロケールやNode版をまたいで安定します。成功時、応答は送った正規化済みfromとtoをエコーし、ホストのDateオブジェクトなしで計算したUnix風の絶対整数秒としてfrom_epoch_secondsとto_epoch_secondsを付けます。total_secondsは符号付き差分toマイナスfromで、終了が後なら正、一致なら零、終了が前なら負です。フラグis_pastとis_zero、方向ラベルforward、backward、zeroにより、ダッシュボードは符号を再計算せず残り対期限超過の文言を選べます。並べ替えに単一数が要るときはtotal_secondsだけ、古典的カウントダウン描画は四部内訳、目標瞬間後に文言を切り替えるならis_pastを使います。

API利用、料金、製品フロー、実用上の限界

必須文字列フィールドfromとtoをISO-8601形で含むJSON本体を送ってください。マーケティングサイト、発券、試験プラットフォーム、運用ダッシュボードがKIT残高下で安定契約を要する場合はプリペイドAPIを使い、成功項目ごとに$0.002、検証失敗はエンジン拒否後に残高を消費しません。SDK作者はdays、hours、minutes、secondsを四桁カウントダウンに直結し、is_pastで期限超過スタイルを駆動でき、どの言語バインディングでも同じ応答形です。

連携の活用例

試験・イベント・登録締切

教育・発券システムは固定ISO締切までの残り時間を計算し、登録終了後はis_pastでUI文言を切り替えます。

SLAと運用ダッシュボード

運用ツールはインシデント開始と目標解決の瞬間を渡し、並べ替え用にtotal_secondsを保存し、状況板に整形した残りを表示します。

技術的な質問

2つの日付の間のカウントダウンはどう得ますか？

fromとtoをISO-8601日時としてJSONで送ります（例 from: "2026-01-01T00:00:00Z" と to: "2026-01-02T01:01:01Z"）。応答にdays、hours、minutes、secondsと符号付きtotal_secondsが含まれます。

終了が開始より前の場合は？

内訳欄は絶対区間で非負のまま、total_secondsは負、is_pastは真、directionはbackwardでUIが期限超過を示せます。

2日付間カウントダウン計算機は無料ですか？

ブラウザツールは端末上で無料です。APIは成功項目ごとに$0.002のプリペイドKIT残高を使い、検証失敗は課金されません。

KITの完全なドキュメントを見る →

2日付間カウントダウン

無料で実行

計算例

fromとtoのISO日時の選び方と受け付ける形式

主な使い道と実用上の限界

活用例

製品ローンチとマーケティングのカウントダウン

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

fromとtoのISO日時の選び方と受け付ける形式

日・時・分・秒・total_secondsと方向の読み方

API利用、料金、製品フロー、実用上の限界

連携の活用例

試験・イベント・登録締切

SLAと運用ダッシュボード

技術的な質問

ありがとう