2つの日付の間の日数

計画立案、請求ウィンドウ、宿題にはブラウザで無料にご利用いただき、CI、レポーティングパイプライン、製品機能で再現可能な日数間隔のフィクスチャが必要な場合は、成功したリクエストごとに$0.002のAPIをご利用ください。

整数日の間隔が意味すること、そしてレスポンスの内容

daysフィールドは常に非負であり、signed_daysは終了日が開始日より早い場合に方向を保持するため、順序が時系列である必要はありません。この計算ツールは両方の日が実在するカレンダー日であることを検証します。その上で、正規化された開始・終了文字列、絶対的な整数日の距離であるdays、通し終了日から通し開始日を引いたsigned_days、他のツールへのパイプ渡しを容易にする構成要素フィールドstart_year・start_month・start_day・end_year・end_month・end_day、そして短い式の説明を返します。両方の入力がサポートされる年の範囲内の実在するカレンダー日であれば間隔は完全に決定され、そうでなければinvalid_inputでリクエストは失敗します。拒否されるケースには、startまたはendフィールドの欠落、2024/01/01のような誤った形式、不可能な月、2023-02-29のような存在しない日、1から9999の範囲外の年が含まれます。

startとendの読み取り方法とカウントを再現可能に保つ仕組み

各文字列は4桁の数字、ハイフン、2桁の数字、もう一つのハイフン、2桁の数字に一致しなければなりません。先頭や末尾の空白はトリムされますが、部分的な日付、通日のみの表記、月名、埋め込まれた時刻はここでは展開されません。解析後、各年は1から9999の間、各月は1から12の間、各日はその年のその月の実際の長さの範囲内でなければならず、うるう年は4で割り切れるが400で割り切れない世紀年を除くというグレゴリオ暦の規則に従います。優先される1番目のフィールドはstartですが、from、date1、a、beginといった別名も受け付けるため、スプレッドシート、クエリ文字列、型付きフォームは列名を変えずに同じ契約を再利用できます。優先される2番目のフィールドはendで、同様の理由でto、date2、b、finishといった別名も受け付けます。内部的には、エンジンはよく知られたdays_from_civilマッピングを用いて各市民暦の3項組を遡及グレゴリオ暦の通し日数に変換し、通し終了日から通し開始日を引いてsigned_daysを求め、それの絶対値をdaysとします。これは実行環境間でビット単位まで安定した純粋な整数算術です。同一の日付は0を生み、ペアを逆にするとsigned_daysの符号のみが反転しdaysは変わりません。自動化されたパイプライン内で同一の日数間隔が必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。

日数間隔の算術が計画立案・請求・ソフトウェアで役立つ場面

開発者はこの契約をスクリプトから呼び出し、スケジューラー用の決定的なテストベクターを生成したり、請求書やサブスクリプションの期間フィールドを検証したり、ホストのDateオブジェクトによるタイムゾーンのずれのない純粋なカレンダー間隔を要求する製品要件を満たしたりします。API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、単発のチェックからパイプラインへ、数学的な結果を変えることなく移行できます。