ForHosting KIT · 開発者向けツール

UTCオフセット間の時間差を符号付きで計算

この計算ツールは、2つの固定UTCオフセット文字列の差を符号付きの時間数で求めます。第1オフセットと第2オフセットを入力すると、時計、場所、夏時間規則、タイムゾーンデータベースを参照せず、第2の値から第1の値を差し引きます。第2オフセットが進んでいれば正、遅れていれば負、UTCからのずれが同じならゼロになります。後続処理に使いやすいよう、正確な分単位の差も返します。

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

無料で実行 API仕様を見る

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

符号付き結果の向きを理解する

計算順序は明確で、第2オフセットから第1オフセットを引きます。AがUTC+02:00、BがUTC+05:30なら、BはAよりUTCから東へ3時間30分進んでいるため、結果は+3.5時間です。同じ入力を逆にすると-3.5時間になります。この符号は、プログラムが第1の固定オフセットの時計表示を第2へ調整する場合に役立ちます。ただし、この機能は日時を受け取ったり変換したりせず、オフセット差だけを報告します。結果がゼロなら、一方がUTC、他方がZという表記でも、両方が同じUTCからのずれを示します。応答には正規化済みの両入力、10進数の時間値、整数の分値が含まれます。分値は30分、15分、そのほかの有効な端数を曖昧なく表し、時間値は一般的に必要とされる答えを直接示します。

固定UTCオフセットを正確な形式で入力する

UTCの後に符号、2桁の時、コロン、2桁の分を続け、UTC+05:30またはUTC-04:00のように入力してください。UTC接頭辞を省略して+05:30や-04:00を送ることもできます。ゼロにはUTCとZを使用できます。文字列全体の前後にある空白は無視しますが、誤った入力を暗黙に解釈しないよう内部の空白は拒否します。時は固定オフセットの民間利用範囲であるマイナス14時間からプラス14時間以内でなければなりません。14時間の両端では分を00とし、それ以外の分は00から59にしてください。符号とコロンを必須にすることで確認しやすくなり、+530と+05:30の混同を防げます。返却値はUTC±HH:MMに正規化されるため、同等の入力形式は一貫した出力になります。無効な値には、推測結果ではなく修正対象のフィールドを示す入力エラーを返します。

固定オフセットで分かる範囲を確認する

固定UTCオフセットは数値的なずれであり、地理的なタイムゾーンではありません。地域のオフセットは、夏時間、行政判断、過去の規則によって変わる場合があります。都市が冬と夏で異なるオフセットを使っても、オフセット文字列だけには適用規則を選ぶための場所や日付が含まれません。そのため、この機能はタイムゾーン検索を行わず、地名から現在の現地時刻を示すものでもありません。この限定された範囲により結果は決定的となり、同じ文字列からは実行時刻や場所にかかわらず常に同じ出力が得られます。設定の検証、別システムが選択済みのオフセット比較、既知のオフセットによる予定計算の準備、数値オフセットを交換する連携のテストにご利用ください。Europe/LondonやAmerica/New_Yorkのような名前付きゾーンから始める場合は、対象時点の固定オフセットを先に解決してから入力してください。

活用例

設定済みサービスのオフセット比較

固定UTCオフセットが既知の2システムについて、符号付き時間差を確認できます。

予定計算の確認

時計表示を第1オフセットから第2オフセットへ移すための調整値を取得できます。

オフセット連携のテスト

正規化値と正確な分差を、API、フォーム、パイプラインの安定したテストデータにできます。

よくある質問

符号はどのように決まりますか？

offset_bからoffset_aを引きます。正なら第2オフセットが進み、負なら遅れています。

夏時間は考慮されますか？

いいえ。日付、場所、タイムゾーン規則を使わず、固定された数値オフセットだけを比較します。

どの入力形式を使用できますか？

UTC±HH:MMまたは±HH:MMを使用してください。ゼロにはUTCとZも使用できます。

30分や15分単位のオフセットに対応しますか？

はい。全体が±14:00以内であれば、00から59までの有効な分を使用できます。

difference_minutesを返す理由は何ですか？

整数の分は計算を正確に保ち、時間差が小数になる場合の後続処理を容易にします。

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

APIリクエストは1回$0.002です。ブラウザー版は外部サービスを参照せずローカルで実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/offset-difference-hours

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

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

curl -X POST https://api.kit.forhosting.com/date/offset-difference-hours \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset_a":"UTC+05:30","offset_b":"UTC-04:00"}'

const res = await fetch("https://api.kit.forhosting.com/date/offset-difference-hours", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "offset_a": "UTC+05:30",
    "offset_b": "UTC-04:00"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/offset-difference-hours",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "offset_a": "UTC+05:30",
    "offset_b": "UTC-04:00"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/offset-difference-hours", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"offset_a":"UTC+05:30","offset_b":"UTC-04:00"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"offset_a":"UTC+05:30","offset_b":"UTC-04:00"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/offset-difference-hours", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "offset_a": "UTC+05:30",
  "offset_b": "UTC-04:00"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.offset_difference_hours",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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