都市間の時差計算
ニューヨーク(UTC−5)が15:00のとき、東京(UTC+9)は翌日の05:00で、時差は14時間です。2つの都市名、UTCオフセット、現地時刻を入れて、電話や旅行の予定づくりに使えます。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 都市 A
- New York
- Utc a
- -5
- 都市 B
- Tokyo
- Utc b
- 9
- 時
- 15
- 分
- 0
- Aの UTC 表記
- UTC-5
- Bの UTC 表記
- UTC+9
- Aの時刻
- 15:00
- Bの時刻
- 05:00
都市間の時差計算は、旅行や通話の日常的な問いに答えます。一方の都市である現地時刻のとき、もう一方は何時で、2つの時計の間に何時間あるのか。両方の都市名と、各都市の固定UTCオフセット(時間単位)を指定します。標準時の New York はマイナス5、Tokyo はプラス9、Auckland はプラス12、Honolulu はマイナス10です。さらに最初の都市の現地時と任意の分を入れます。符号付き時差、双方の現地時計 HH:MM、正子折り返し後の暦日ずれ、プラスマイナス12時間窓への最短経路ラップ、2つのオフセットが半日超離れている(日付変更線横断の民用判定)フラグを返します。プラスマイナス14時間の外のオフセットは拒否されます。
時間差と双方の現地時計の求め方
都市の民用時計は、関心のある季節スケジュールが分かっていれば、協定世界時からの固定オフセットとして書けます。
Eastern Standard Time の New York は UTC マイナス5、Tokyo は UTC プラス9、Delhi は UTC プラス5.5、Adelaide は UTC プラス9.5、Kathmandu は UTC プラス5.75です。本計算はそれらの数値を代行検索しません。
都市名はラベルとして、2つのオフセットは時間として入力し、最初の都市の時計がすでに示す現地時と、任意で分を与えます。符号付き時差は常に都市 B のオフセットから都市 A のオフセットを引いた値です。この1回の引き算が、同一瞬間における最初の都市の現地時刻に足して2番目の都市の現地時刻を得る時間数です。
作業は整数分で進めるため、30分帯や15分帯も正確です。差に60を掛けて最も近い分に丸め、時×60+分に加えます。分の合計を24時間時計へ折り畳みます。
完全な日を除いた残りが都市 B の HH:MM で、除いた完全日数が暦日オフセットです。UTC マイナス14と UTC プラス14の実在端ではマイナス2からプラス2まで取り得ます。2都市が同じオフセットなら時計は一致し、日オフセットは0です。
異なる場合は、どちらが進んでいるかを名付け、双方の時計を出し、通話や会議を予約する前に手計算で検算できる代入手順を列挙します。
国際日付変更線をまたぐ日の繰り上がり
国際日付変更線は経度180度付近で暦日が飛ぶ民用の継ぎ目です。その東側の都市は大きな正のオフセットを使います。Auckland の UTC プラス12、Samoa の UTC プラス13、Line Islands の UTC プラス14などです。
西側は大きな負のオフセットで、Honolulu の UTC マイナス10、American Samoa の UTC マイナス11、Baker Island の UTC マイナス12です。これらのオフセットを引くと12時間超、端では24時間超の隙間になり、現地時計に足すと前日や翌日だけでなく2日先へ着地し得ます。2つの時計が半日超離れている民用判定です。
古典的な組が契約を示します。UTC マイナス5の New York の15時は、UTC プラス9の Tokyo では翌暦日の05時です。プラス14時間の隙間が日付変更線を立て、逆回りではマイナス10時間にラップします。
UTC プラス12の Auckland の正午は、UTC マイナス10の Honolulu では前暦日の14時です。マイナス22時間の隙間はプラス2時間にラップします。UTC プラス13の Samoa の朝9時は、UTC マイナス11の American Samoa では前日の朝9時です。
同じ文字盤で24時間かつ暦日1日の差です。
活用例
海を越えた通話の予定を入れる
ご自身の都市の現地時を選び、相手都市の UTC オフセットを入れ、会議招待を送る前に双方の時計と暦日注記を確認します。
日付変更線の旅行日を確かめる
Auckland と Honolulu、または Samoa と American Samoa を比べ、到着地の暦が昨日・今日・2日ずれのいずれかを見ます。
旅程メモに都市時計を書く
2都市にラベルを付け、公表されている UTC± オフセットを固定し、タイムゾーンDBを開かずに HH:MM の組と時差を行程へ落とします。
よくある質問
2都市の時差はどのように求めますか?
両方の都市名、各都市の固定 UTC オフセット(時間)、最初の都市の現地時を入れてください。
時計が近く見えるのに暦日が違うのはなぜですか?
日付変更線をまたぐと生の隙間は 22 や 24 時間になり得ます。文字盤は2時間差、あるいは同一に見えても、都市 B は前日または翌日です。
都市名からタイムゾーンを引きますか?
いいえ。 都市名は表示用ラベルだけです。固定 UTC オフセットをご指定ください。ソルバーはタイムゾーンDBを呼ばず、DST も適用せず、ホスト時計も読みません。
夏時間はどう扱えばよいですか?
入力する前に、知りたい季節のオフセットを選んでください。この計算は入力された固定のオフセットを使うため、ニューヨークは標準時ならマイナス5、夏時間なら夏時間のオフセットを入れます。
30分や15分単位の時間帯にも対応していますか?
はい。オフセットは小数で入力でき、デリーはプラス5.5、アデレードはプラス9.5、カトマンズはプラス5.75です。計算は分単位で行うので、こうした時間帯も正確です。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/travel/time-difference-cities \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}'const res = await fetch("https://api.kit.forhosting.com/travel/time-difference-cities", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"city_a": "New York",
"utc_a": -5,
"city_b": "Tokyo",
"utc_b": 9,
"hour": 15
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/time-difference-cities",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"city_a": "New York",
"utc_a": -5,
"city_b": "Tokyo",
"utc_b": 9,
"hour": 15
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/time-difference-cities", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/time-difference-cities", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"city_a": "New York",
"utc_a": -5,
"city_b": "Tokyo",
"utc_b": 9,
"hour": 15
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.time_difference_cities",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_abs_offset_hours | 14 |
max_city_len | 80 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
算術は決定的で、ネットワークもホスト時計も IANA ゾーンDBも夏時間の推測もなく、無料のブラウザ実行と API は常に一致します。
国際日付変更線をまたぐ日の繰り上がり
本エンドポイントはその状況を後付けではなく第一級のデータとして扱います。フィールド hour_diff は生の符号付き隙間です。hour_diff_wrapped はその隙間をマイナス12からプラス12の半開区間の一意な代表へ写像し、24時間時計の短い回り方です。ブール値 crosses_date_line は、生の絶対隙間が12時間より真に大きいときだけ真です。搭乗券に火曜と書くか水曜と書くかを旅行者へ伝えるとき、壁時計の読みだけでなくこれらのフィールドを使います。
入力契約、エラー、このページが適切な場合
hour は都市 A の24時間制の整数現地時で0から23です。minute は任意で省略時は0、指定時は0から59の整数です。輸送では別名を受け付けます。ここでの検索意図は消費者向けの都市間時差であり、生のタイムゾーンオフセット同一性でも飛行時間の到着時計でもありません。オフセットを選ぶ前に夏時間はご自身で解決するか、IANA 識別子しかない場合は名前付きゾーン変換を使ってください。無効入力は前払い残高を消費しません。必須5欄と任意1欄の JSON 本体を POST します。city_a と city_b はトリム後80文字以内の空でない名前で、結果のラベルでありタイムゾーンDBのキーではありません。utc_a と utc_b は時間単位の有限 UTC オフセットで、マイナス14からプラス14を含み、インド・ネパール・オーストラリアの30分帯が正確になるよう分数でも構いません。city_a には from_city、city、a_name。city_b には to_city、b_name。utc_a には offset_a、from_offset、utc_from。utc_b には offset_b、to_offset、utc_to。hour には hour_a、h、local_hour。minute には minute_a、m、local_minute。欠落した名前、空文字、非有限オフセット、範囲外の時分、非整数の hour や minute、絶対値が14時間を超えるオフセットは、欄名付きの invalid_input で失敗し、課金されません。成功時は都市、丸めたオフセット、UTC±ラベル、入力時計、双方の HH:MM、符号付き・絶対・ラップ済み時差、day_offset と day_label、日付変更線フラグ、ahead_city と behind_city、1行メッセージ、順序付き手順をエコーします。成功した API 呼び出しは1件あたり $0.002 です。
技術的な質問
crosses_date_line は何を意味しますか。
絶対時差が 12 より大きいとき真です。半日超離れた時計を示す民用判定で、太平洋/日付変更線の組の典型的な印です。
都市間の時差計算の料金はいくらですか。
ブラウザ用具は無料です。API 要求は成功1件あたり $0.002 の前払い KIT 残高を使います。無効入力は課金されません。