ForHosting KIT · 開発者向けツール

2つの時間区間の間隔をUTCで計算

この計算ツールは、明示的な2つのISO日時区間を隔てる経過時間を測定します。各区間の開始と終了をUTC記号または数値オフセット付きで指定すると、比較前にUTCへ正規化されます。区間が重なる場合や境界で接する場合は0を返します。ミリ秒、秒、ISO 8601形式の期間、時間的な順序も同時に確認できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

明示的なオフセット付きの完全な区間を入力します

最初の区間の開始と終了、次の区間の開始と終了という4つの値を指定してください。各値は<code>2026-07-25T09:00:00Z</code>や<code>2026-07-25T12:00:00+01:00</code>のような完全なISO 8601日時である必要があります。ゾーンを明記するため、端末のローカル設定に左右されません。各開始は対応する終了以前にしてください。小数秒は3桁まで対応します。日付のみ、ゾーン名、うるう秒、オフセットなしの値は推測せず拒否します。元データがゾーン名を使う場合は、各端点の日付に有効なオフセットへ事前に変換してください。

UTC間隔の計算方法を確認します

各端点は暦の算術によってUTCミリ秒位置へ変換されます。最初の区間が次の開始より前に終わる場合は、次の開始から最初の終了を引きます。順序が逆なら演算も逆にします。それ以外では区間が接触または重複するため、間隔は0です。したがって+01:00の12:00は11:00Zと同じ瞬間です。応答にはミリ秒、秒、ISO 8601期間、順序ラベルが含まれます。現在時刻、ロケール、ネットワーク、実行環境の日付パーサーを使用しないため、結果は常に決定的です。

スケジュール処理で結果を安全に利用します

0以上の結果は、予約、障害、稼働期間の間の空き時間を測る際に役立ちます。どちらが先か必要な場合は順序ラベルをご確認ください。<code>overlap_or_touch</code>は重複と接触を意図的にまとめた状態で、どちらも時間的な間隔を残しません。重複時間、営業時間、接触と交差の区別には専用の計算をご利用ください。ブラウザーはAPIと同じ純粋な計算処理を実行します。APIリクエストの料金は$0.002です。1秒未満の厳密な比較にはミリ秒を保持し、交換や表示にはISO期間をお使いください。

活用例

予約間の余裕を確認します

明示的なタイムゾーンオフセットを正規化し、予約間の正確な空き時間を測定します。

イベント時系列を分析します

異なるUTCオフセットで記録された2件の障害間の無通信時間を計算します。

予定の間隔を検証します

入力順序にかかわらず、2つの稼働時間帯に十分な間隔があるか確認します。

よくある質問

区間が重なる場合はどうなりますか？

区間を隔てる時間がないため、間隔は0、順序はoverlap_or_touchになります。

片方の終了ともう片方の開始が同時の場合はどうなりますか？

区間が接しているため、返される間隔は正確に0です。

異なるタイムゾーンオフセットに対応していますか？

はい。比較前に各端点をZまたは明示的な数値オフセットからUTCへ正規化します。

タイムゾーンオフセットを省略できますか？

いいえ。サーバー、ブラウザー、端末のゾーン設定に依存しない計算にするため必須です。

結果の精度はどの程度ですか？

入出力はミリ秒精度に対応し、間隔は秒とISO 8601期間でも返されます。

APIリクエストの料金はいくらですか？

公開基本料金は1リクエストあたり$0.002です。同じ決定的な計算をブラウザーでも利用できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/intervals-gap

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

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

curl -X POST https://api.kit.forhosting.com/date/intervals-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_start":"2026-07-25T09:00:00Z","first_end":"2026-07-25T10:30:00Z","second_start":"2026-07-25T12:00:00+01:00","second_end":"2026-07-25T13:00:00+01:00"}'

const res = await fetch("https://api.kit.forhosting.com/date/intervals-gap", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "first_start": "2026-07-25T09:00:00Z",
    "first_end": "2026-07-25T10:30:00Z",
    "second_start": "2026-07-25T12:00:00+01:00",
    "second_end": "2026-07-25T13:00:00+01:00"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/intervals-gap",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "first_start": "2026-07-25T09:00:00Z",
    "first_end": "2026-07-25T10:30:00Z",
    "second_start": "2026-07-25T12:00:00+01:00",
    "second_end": "2026-07-25T13:00:00+01:00"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/intervals-gap", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"first_start":"2026-07-25T09:00:00Z","first_end":"2026-07-25T10:30:00Z","second_start":"2026-07-25T12:00:00+01:00","second_end":"2026-07-25T13:00:00+01:00"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"first_start":"2026-07-25T09:00:00Z","first_end":"2026-07-25T10:30:00Z","second_start":"2026-07-25T12:00:00+01:00","second_end":"2026-07-25T13:00:00+01:00"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/intervals-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "first_start": "2026-07-25T09:00:00Z",
  "first_end": "2026-07-25T10:30:00Z",
  "second_start": "2026-07-25T12:00:00+01:00",
  "second_end": "2026-07-25T13:00:00+01:00"
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_chars 35

エラー

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

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