ForHosting KIT · 日付・時間

相対日付の解析

2020年1月10日12時(UTC)を基準にすると、in 3 daysは2020年1月13日12時(UTC)になります。英語かスペイン語の短い表現と基準の時点を入力すると、それが指す正確な日時が分かります。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
テキスト
in 3 days
基準日時
2020-01-10T12:00:00.000Z
結果
ISO 日時
2020-01-13T12:00:00.000Z
Unix タイムスタンプ(ミリ秒)
1,578,916,800,000

英語とスペイン語の有限な相対表現を、指定した基準時刻を起点として絶対的な ISO タイムスタンプへ解釈・変換します。曖昧または無限の表現は拒否します。

表現から正確な日時へ

私たちは「3日後」「数週間後」「少し前」のように、日付を相対的に書くことがよくあります。こうした表現は、どこから数えるかが決まるまで意味が定まりません。そのためこのツールは基準の時点を入力してもらい、そこから先や前に数えて正確な結果を出します。時刻はそのまま引き継がれるので、正午から数えた表現は正午になります。2020年1月10日12時(UTC)を基準にすると、in 3 daysは2020年1月13日12時(UTC)です。結果は読みやすい日時と、ミリ秒の1つの数値の両方で受け取れます。

確かな答えを得るために

最もよくある戸惑いは基準の時点に関するものです。別の起点から数えると、同じ表現でも別の日を指すので、大事な場合は結果と一緒に基準も残しておいてください。このツールが扱うのは英語とスペイン語の限られた短い表現で、どんな文でもよいわけではありません。空の入力や文字ではない値は、計算の前に受け付けません。処理はすべてお使いの端末で行われ、インターネット上の情報は参照しないため、同じ表現と同じ基準なら、表計算を使わなくてもいつも同じ答えになります。

境界事例と制限

空の文字列、誤った型、そして矛盾する範囲は、いかなる計算よりも前の非常に早い段階で拒否されますので、不正な形式のデータや想定外のデータに対しても、動作は予測可能なままです。タイムゾーンを持たない市民日付は、結果を誤らせる暗黙の変換を一切行わず、単純な暦日として扱われますので、意図しないずれが生じる心配はありません。

参照用のテーブルは機能のフォルダー内に同梱されており、実行時にはネットワーク呼び出しが一切行われませんので、機密性と速度の両方が保たれます。組み込みの前には、提供されている例を必ず確認してください。

日々の業務

表計算ソフトを使わずに、信頼できる答えが得られます。

教育

デモ用の安定した参照用の例をご利用いただけます。

相対日付とは何ですか?

in 3 daysのように、起点があって初めて意味を持つ表現です。それだけではどの日か決まりませんが、基準の時点があれば1つの正確な日時を指します。

基準の時点は何のためにありますか?

表現を数え始める瞬間です。同じ表現でも基準が違えば結果も変わるので、後で計算をやり直す必要がある場合は、使った基準を控えておいてください。

どの言語で表現を書けますか?

英語かスペイン語です。自由な文章ではなく、この2つの言語の限られた短い相対表現を理解するので、答えがいつも予測どおりになります。

結果には何が含まれますか?

2020-01-13の12時(UTC)のようなISO形式の日時と、同じ瞬間をミリ秒で表した数値、この例では1578916800000が含まれ、表計算や別のツールにそのまま使えます。

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

POSThttps://api.kit.forhosting.com/date/relative-parse

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

curl -X POST https://api.kit.forhosting.com/date/relative-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"in 3 days"}'
{
  "text": "in 3 days"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.relative_parse",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

仕組み

この機能は、英語またはスペイン語で書かれた有限な相対表現を解釈し、あなたが指定した基準時刻を起点として、絶対的な ISO-8601 タイムスタンプへ変換します。同じ入力に対しては常に同じ出力が得られますので、キャッシュや比較検証も安心して行えます。計算は完全に決定論的であり、API とまったく同じ純粋関数を用いてお使いのブラウザー内で無料で実行されますので、オフラインでもオンラインでも結果は常に一致します。すべての入力は算術演算を行う前に検証されるため、型が正しくない場合には、明確で安定した invalid_input エラーとして直ちに通知されます。この機能を本番のワークフローや自動テストへ組み込む前には、成功する場合とエラーになる経路の両方、検証の順序、ブラウザーと API の同等性、そして許容範囲を超える浮動小数点値の安全な取り扱いまでを網羅した、参照用の例に必ず目を通してください。これらの例を先に確認しておくことで、統合作業がずっとスムーズになります。

入力と出力

重要なシステムや、長期にわたって信頼性を維持しなければならない自動テスト群へこの機能を接続する前には、検証の順序、結果の決定論性、そして認証のためのエラー一致文字列に関する参照用の例を、どうか注意深くお読みください。この一手間が、後々の不具合を大きく減らしてくれます。スキーマの必須フィールドは必ず存在し、正しい型でなければなりません。一方、任意のフィールドには文書化された既定値が用いられ、必要に応じて上書きすることもできます。成功時の応答には常に主要な出力フィールドが含まれますので、画面のバインディングは実行のたびに安定し、予測可能な状態を保ちます。そのため、追加のチェックをご自身で書き足す必要はありません。IEEE-754 の精度を超えるほど極端に大きな中間値は、静かに null になるのではなく、明示的な範囲超過エラーを返しますので、後続の計算で予期しない不具合が生じることを防げます。

境界事例と制限

それらの例は、検証の順序、ブラウザーと API の同等性、認証のための安定したエラー一致文字列、そして書式が許容する範囲の外にある浮動小数点値の安全な取り扱いを、丁寧に文書化しています。

自動化

ウィジェットと API で同じ純粋関数を使用します。

無料ですか?

はい、ブラウザー内で使えるティア A です。

ネットワークは?

ネットワークは不要で、端末上で解析します。

無効な入力は?

明確な一致を伴う invalid_input エラーになります。

安定していますか?

決定論的な参照例が仕様を固定します。

作者は?

samurai。

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