ForHosting KIT · 日付・時間

日時を単位で切り捨て

Q: 切り捨てはローカルのタイムゾーンを使いますか？

いいえ。 床は常に明示的な入力文字列から UTC で計算されます。文字列内のオフセットは先に UTC へ変換され、ホスト時計は読みません。

日時をUTCで年・月・日・時・分の始まりに切り捨てます。2024-06-15T14:37:52Zを日で切り捨てると2024-06-15T00:00:00Zです。日次の集計や時間別のグラフ、記録の分類に使えます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

日時: 2024-06-15T14:37:52Z day

結果

結果: 2024-06-15T00:00:00Z day
年: 2,024
月: 6
日: 15

タイムスタンプをより粗い単位へ切り捨てることは、日次バケット、月次レポート、時間グラフ、言語やホストをまたいで一致すべきキャッシュキーの基礎です。存在しない暦日や未知の単位は繰り上げを捏造せず、明確な検証エラーで失敗します。

システム時計なしでUTC切り捨てが動く仕組み

暦日だけが渡された場合は協定世界時の午前零時として扱います。時刻がある場合は、整数秒へ切り捨てられる任意の小数秒と、UTC を示す末尾 Z、または絶対時刻への変換時に差し引く符号付き時分オフセットを受け付けます。

グレゴリオのうるう規則で民事日が存在すること——2月29日は年が4で割り切れ、かつ世紀年は400でも割り切れるときだけ合法——と、時・分・秒が通常範囲にあることを検証します。

Howard Hinnant の days-from-civil で民事の三項を日シリアルへ変換し、八万四千六百秒を掛け、現地の時刻を加え、オフセット分に六十を掛けた値を引いて UTC のエポック秒を得ます。civil-from-days で UTC の年・月・日・時・分・秒を再構成します。続けて単位ごとの純粋な床を適用します。

year は月と日を1にし時計を零、month は年月を保ち日を1・時計を零、day は暦日を保ち時計を零、hour は分と秒を零、minute は秒のみ零にします。パイプライン全体は決定的な整数演算であり、乱数種・ホストのタイムゾーン表・夏時間DB・ネットワークは使わないため、教材デモと本番フィクスチャは常に同じバケット境界で一致します。

日時を単位で切り捨てる計算機が役立つ場面

分析パイプラインは取り込みタイムスタンプを床にして日次・時間キーを物質化し、言語や地域を問わず同じ UTC バケットを共有します。財務と運用のチームは台帳行やサポートチケットを月・日の期間にまとめ、オフライン監査と一致する決定的な要約を作ります。

プロダクトと成長のダッシュボードは安定した床で時間または日の活動を描き、ブラウザのプレビューとバックエンド集計が夏時間の切り替わりで一時間ずれないようにします。下層の算術が似ていても、解くクエリは別物です。

活用例

日次・時間の分析バケット

ISO イベント時刻を UTC の日または時へ床し、パイプラインの各言語がチャートとロールアップ用に同じ集計キーを物質化します。

月次・年次の報告期間

台帳やチケットの日時を月または年へ切り捨て、エクスポート・監査・財務要約のための決定的な期間開始を作ります。

よくある質問

対応している単位は？

大文字小文字を区別しない五つのトークンのみです: year, month, day, hour, minute。

切り捨てはローカルのタイムゾーンを使いますか？

いいえ。床は常に明示的な入力文字列から UTC で計算されます。文字列内のオフセットは先に UTC へ変換され、ホスト時計は読みません。

月や年で切り捨てると何になりますか？

月で切り捨てると、その月の1日の午前0時（UTC）になります。年で切り捨てると、その年の1月1日の午前0時（UTC）になり、それより小さい部分はすべて0になります。

時差付きで書いた時刻はどう扱われますか？

まずUTCに直してから切り捨てます。そのため、プラスの時差がある時刻は、元の表記とは別の時間や、別の日付になることがあります。

存在しない日付を入れるとどうなりますか？

繰り上げずに、存在しない日として受け付けません。たとえば平年の2月29日を入れても、うっかり翌月の日付になることはありません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/truncate-to-unit

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

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

curl -X POST https://api.kit.forhosting.com/date/truncate-to-unit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}'

const res = await fetch("https://api.kit.forhosting.com/date/truncate-to-unit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/truncate-to-unit",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/truncate-to-unit", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-06-15T14:37:52Z","unit":"day"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/truncate-to-unit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "datetime": "2024-06-15T14:37:52Z",
  "unit": "day"
}

レスポンス例

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

技術的な注記

ホストのタイムゾーンや夏時間表があると、素朴な床演算はブラウザ・サーバー・エッジ Worker の間でずれます。この日時単位切り捨てツールは、明示的な ISO-8601 日時（Z または数値オフセット付きの完全な時刻、または UTC 午前零時として扱う日付のみ）と、year・month・day・hour・minute のいずれかの単位を受け取ります。純粋なグレゴリオ暦算術で入力を協定世界時へ正規化し、選んだ単位より細かいフィールドをすべて零にして、結果を年-月-日 T 時-分-秒 Z として安定した UTC 床瞬間にします。無料のブラウザフォームと有料 API は同一の同型関数を共有し、成功1件あたり $0.002 です。

システム時計なしでUTC切り捨てが動く仕組み

国際的な ISO 形式で書かれた明示的な基準日時から始め、すべてのクライアントが同じ年・月・日と任意の時刻フィールドで合意できるようにします。切り捨て後の民事フィールドを四-二-二 T 二-二-二 Z 文字列に整形します。

送信内容と返却内容

古典的な確認として、十四時三十七分を UTC 午前零時の日へ、プラス二オフセットの朝のタイムスタンプを純 Z の時へ、月の一日へ、年の一月一日へ床し、平年の2月29日を拒否します。無料ブラウザフォームで素早く確認し、大量のレポートバケットや回帰フィクスチャが必要なときはスクリプトから同じ契約を呼び出してください。必須は二つです。 datetime は ISO-8601 文字列（例: 二千二十四ハイフン零六ハイフン十五 T 十四コロン三十七コロン五十二 Z）、unit は year・month・day・hour・minute のいずれか（大文字小文字を区別しません）。基準文字列には date・dt・timestamp・ts、単位には to・truncate_to・granularity の別名を受け付けます。欠落フィールド、文字列でない datetime、ISO 形に合わない文字列、存在しない暦日、無効な時刻成分、許可された五トークン外の単位は invalid_input で失敗し課金されません。成功時は、トリムした基準 datetime、正規化済み小文字の unit、切り捨て後の UTC ISO 文字列、床瞬間の数値 year・month・day・hour・minute・second、結果の epoch_seconds、UTC 床規則を示す短い formula を返します。成功した API 呼び出しの価格は公開ベースの $0.002 毎件で、検証失敗はプリペイド残高を消費しません。

日時を単位で切り捨てる計算機が役立つ場面

能力は純粋な parse エンジンのため、API 価格は成功1件あたり公開ベースの $0.002 で、検証失敗は残高を消費しません。後からタイムスタンプに時間や日を足す、二日付の日数を数える、月の開始と終了を求める、時間と分の純単位換算が必要なら、この truncate-datetime-to-unit のページを過負荷にせず、別の検索意図とランディングとして扱ってください。

連携の活用例

バケット境界の QA フィクスチャ

ホスト時計なしで、午前零時・月初・オフセットから UTC への変換をまたぐ期待床瞬間を生成し、回帰テストに使います。

技術的な質問

日時を UTC の日に切り捨てるには？

datetime を ISO-8601 文字列、unit を day として送ってください。API は数値オフセットを UTC に正規化した後、同じ暦日の 00:00:00Z を返します。

無効な暦日ではどうなりますか？

2023-02-29 のような不可能な日付は invalid_input で失敗します。3月へ繰り上げたりうるう日を捏造したりしません。

日時を単位で切り捨てるツールの料金は？

ブラウザ版は無料です。API は成功した呼び出しごとに KIT プリペイド残高から $0.002 を使い、無効入力は課金されません。

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

日時を単位で切り捨て

無料で実行

計算例

システム時計なしでUTC切り捨てが動く仕組み

日時を単位で切り捨てる計算機が役立つ場面

活用例

日次・時間の分析バケット

月次・年次の報告期間

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

システム時計なしでUTC切り捨てが動く仕組み

送信内容と返却内容

日時を単位で切り捨てる計算機が役立つ場面

連携の活用例

バケット境界の QA フィクスチャ

技術的な質問

ありがとう