ForHosting KIT · 暮らし・料理・趣味

時刻の経過時間

09:30から14:45までは5時間15分で、22:15から06:40までの夜勤も日付をまたいで正しく計算します。日付なしで24時間表記の時刻を2つ入力すると、経過した時間と分が分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

開始時刻: 09:30
終了時刻: 14:45

結果

開始: 09:30
End: 14:45
時間: 5
分: 15

09:30 から 17:45 までは何時間何分でしょうか。22:15 に始まり 06:40 に終わる夜勤はどれくらい続くでしょうか。時刻の経過時間計算機は、カレンダー上の日付を求めずに、こうした日常の問いに答えます。24時間制の2つの時刻を入れると、経過した時と分が返ります。終了が開始より早いときは、日付変更線を一度またぎます。25:00 や 9:30 AM のような不正な時刻は、黙って読み替えるのではなく拒否されます。ネットワーク呼び出しもシステム時計も乱数もなく、あるのは正子からの分数と、必要なときの24時間の一度きりの加算だけです。

2つの時刻が時と分になる仕組み

24時間制の時刻は、円環の民事日の上の位置であり、長さでも暦日でもありません。朝の9時30分は正子から570分、14時45分は正子から885分です。その正子からの分数を引き算すると、同じ民事日に両方の読みがあるときの経過区間が出ます。

885引く570は315分で、5時間15分に分かれます。終了が開始より早いとき — 22時15分から6時40分の夜勤、日付変更をまたぐ駐車、23時10分から6時50分の睡眠窓 — 素朴な引き算は負になります。そこで時計時間の規則は、民事日の長さである1440分を足します。

区間は日付変更を一度だけまたぎ、0時間0分から23時間59分までの閉区間に収まります。開始と終了が同じなら、経過は丸一日ではなくゼロです。二つの読みが文字盤上の同じ瞬間を指すからです。

アルゴリズムはシステム時計を見ず、ネットワークサービスを呼ばず、乱数も使いません。

時刻の経過時間計算機が役立つ場面

壁時計の2つの読みを、暦日を捏造せずに長さへ変えたいときに、時刻の経過時間計算機を使います。駐車場や車庫の仕組みは、入場時刻から退場時刻までの滞在を見積り、車が正子のあとに出るときは夜間またぎも含めます。保護者と指導者は、16時開始・17時45分終了の練習を計ります。

看護、指令、ホテルの夜受付は、遅く始まり翌朝早く終わる区間を求めます。経過時間を学ぶ生徒は、09:30 から 14:45 が5時間15分であり、紙の上の繰り下げ誤りではないことを確かめます。12時間制の AM/PM と違法な時を拒むので、25:00 を受け付けてはならない受付フォームの24時間形式検査にもなります。

暦日のあいだの全日数が必要なら日付差やカウントダウンの道具と、2つの長さを足したいなら時間の足し算計算機と組み合わせてください。実装は純粋な parse の tier A です。検証失敗は前払い残高を消費しません。

活用例

夜勤と日付変更をまたぐ勤務時間

22:15 開始と 06:40 終了を、小数時間ではなく文字盤の経過が必要な勤務表向けに、8時間25分へ直します。

駐車と予約の滞在時間

車、法廷枠、診療の訪問が入場時刻から退場時刻まで何分続いたかを求めます。日付変更のまたぎも含みます。

授業での経過時間の検算

09:30 から 14:45 が5時間15分であること、25:00 が違法な24時間制時刻として拒まれることを、生徒に確認させます。

よくある質問

終了時刻が開始より早いとどうなりますか？

区間は日付変更を一度またいだと見なします。22:15 から 06:40 なら結果は 8時間25分で overnight は真です。同じ時刻なら丸一日ではなくゼロです。

どの時刻形式が受け付けられますか？

24時間制の H:MM または HH:MM だけです。時は 0–23、分は 00–59。時の先頭ゼロは任意です。秒、ISO 日時、12時間制 AM/PM は拒否されます。

開始時刻と終了時刻が同じ場合はどうなりますか？

結果はゼロで、丸1日にはなりません。同じ2つの時刻は時計の上で同じ瞬間を指すため、その間に24時間たったとはみなしません。

24時間を超える長さも計算できますか？

いいえ。日付をまたぐのは1回だけなので、結果はゼロから23時間59分までです。数日にわたる場合は、日付の間を数えるツールをお使いください。

合計の分数も分かりますか？

はい。時と分に加えて正確な分数も表示され、勤務表や駐車時間の確認に便利です。09:30から14:45までなら315分です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/life/clock-duration

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

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

curl -X POST https://api.kit.forhosting.com/life/clock-duration \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_time":"09:30","end_time":"14:45"}'

const res = await fetch("https://api.kit.forhosting.com/life/clock-duration", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_time": "09:30",
    "end_time": "14:45"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/clock-duration",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_time": "09:30",
    "end_time": "14:45"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/clock-duration", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_time":"09:30","end_time":"14:45"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_time":"09:30","end_time":"14:45"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/clock-duration", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "start_time": "09:30",
  "end_time": "14:45"
}

レスポンス例

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

技術的な注記

2つの時刻が時と分になる仕組み

同じ時刻文字列の組は、常に同じ時・分・total_minutes・overnight 旗を返します。

入力契約、24時間形式、および誤り

時の先頭ゼロは任意なので、9時5分と 09:05 は同じ瞬間です。欠落欄、前後空白を除いたあとの空文字、文字列でない値も失敗します。この契約は文字盤形式であり、長さの加算器でも自由文の解析器でもないからです。不正な入力は課金されません。要求本体は必須の2文字列 start_time と end_time を運びます。それぞれは H:MM または HH:MM 形式の正しい24時間制時刻で、時は0から23の整数、分は00から59の2桁整数でなければなりません。9:30 AM のような12時間制、暦日を含む ISO 日時、14:30:00 のような秒付き、24:00・25:00・12:60 のような範囲外はすべて invalid_input で失敗し、問題の欄を名指しします。start_time には別名 start・from・begin を、end_time には別名 end・to・until・stop を受け付けるので、既存の名前のままフォームやスクリプトを送れます。成功時は、2桁の HH:MM に正規化した両時刻、整数の経過時と分、正確な整数分である total_minutes、終了が開始より早いときだけ真の overnight、5h 15m のような pretty 文字列、答えの横に出せる短い式を返します。成功した API 呼び出しは公表の基本料金 $0.002 を使います。

時刻の経過時間計算機が役立つ場面

シフト監督は、小数時間を拒む勤務表のために start_time と end_time を時と分へ直します。モデルトークンも外向き HTTP も Date オブジェクトもありません。遅延はわずかな算術に留まり、成功した API 要求あたりの料金は $0.002 で正直です。

技術的な質問

2つの時刻のあいだの経過時間はどう計算しますか。

start_time と end_time を24時間制の HH:MM 文字列で送ってください。API はそれぞれを正子からの分へ直し、引き、終了が早ければ 1440 分を足し、時と分を返します。

なぜ 9:30 AM や 25:00 は拒否されますか。

この契約は24時間の文字盤です。12時間の子午標識と 0–23 の外の時は正しい24時間形式ではないので、invalid_input で失敗し、課金されません。

時刻の経過時間計算機の料金はいくらですか。

ブラウザの道具は無料です。API 要求は成功1回あたり $0.002 の前払い残高を使います。不正な入力は課金されません。

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

時刻の経過時間

無料で実行

計算例

2つの時刻が時と分になる仕組み

時刻の経過時間計算機が役立つ場面

活用例

夜勤と日付変更をまたぐ勤務時間

駐車と予約の滞在時間

授業での経過時間の検算

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

2つの時刻が時と分になる仕組み

入力契約、24時間形式、および誤り

時刻の経過時間計算機が役立つ場面

技術的な質問

ありがとう