2つの日付間の月数

この2つの日付間の月数計算ツールは、ISO形式の暦日のペアを受け取り、グレゴリオ暦のうるう年規則の下で純粋な整数演算により各日付を検証し、早い方の日付を月末クランプ付きで月ごとに進め、フォーム、スプレッドシート、APIがカレンダーのエッジケースを再実装せずに固定できる、構造化された「丸の月数＋残りの日数」の結果を返します。この経路はシステム時計、乱数、ネットワークに一切触れないため、同じfromとtoの文字列からは、継続的インテグレーションでも本番環境でも常に同じJSONが生成されます。

fromとtoのISO日付の選び方と受け付けられる形式

各値は、4桁の年・月・日からなるISO形式の暦日、たとえば2024-01-15のような形式にしてください。時・分・秒、任意の小数秒、UTCを表す末尾のZ、+02:00のような数値オフセットを含む完全なISO-8601日時を送ることもできます。年は1から9999まで、月は1から12までに制限され、日は該当する場合のうるう年の2月29日を含め、その月に存在する日でなければなりません。これらの範囲外のものは、黙って翌月へ繰り越されるのではなく無効入力になります。fromとtoという名前の2つの文字列フィールドを送信します。時刻が含まれる場合、エンジンは時刻フィールドを検証してありえない時刻を拒否しますが、丸の月数と残りの日数の計算には民用の年月日部分のみが使われます。これにより、秒単位のカウントダウンではなく2つの日付間の月数を探す方々にとって誠実な製品になっています。エイリアスのstart、begin、start_dateはfromに、end、until、end_date、targetはtoにマッピングされ、一般的なフォームやAPIの命名に対応しています。両方のフィールドは必須です。どちらかの省略、文字列でない値、空白のみの入力は、欠落している側を明示するinvalid_inputを発生させます。

months・days・total_days・符号付きフィールド・directionの読み方

monthsは、月末クランプを使い、早い方の日付から遅い方の日付を越えずに進められる最大の丸の月数です。1月31日に1か月を足すと2月の最終日になります。formatted文字列はmonthsとdaysを「14か月と23日」のようなコンパクトな1行にまとめ、素早いUIラベルに使えます。成功時のレスポンスには、元のfromとtoの文字列に加え、YYYY-MM-DD形式に正規化されたfrom_dateとto_dateが含まれます。monthsとdaysフィールドは常に非負で、2つ合わせて絶対的な民用期間を表します。daysフィールドはその進行後に残る民用日数の差なので、1月中旬から3月初めまでの期間は、純粋な日数の合計だけでなく「1か月と数十日」と報告されることがあります。total_daysフィールドは2つの日付の民用日番号の絶対差で、順序を問わない日数も必要な場合に便利です。終了が開始より早い場合、is_pastはtrue、directionはbackwardとなり、signed_monthsとsigned_days_remainderには負の符号が付きますが、monthsとdaysは表示用に非負のままです。両方の日付が一致する場合、is_zeroはtrue、directionはzeroとなり、すべての量はゼロです。人間向けの文にはmonthsとdays、長さでの並べ替えにはtotal_days、製品の文言で「残り」と「期限超過」を言い分ける必要がある場合にはdirectionをお使いください。

APIの使い方・料金・製品ワークフロー・実用上の制限

必須の文字列フィールドfromとtoをISO日付として含むJSONボディを送信します。請求システム、人事の勤続ボード、不動産プラットフォーム、プロジェクトプランナーが安定した契約を必要とする場合は、KIT残高から成功した1件あたり$0.002のプリペイドAPIをご利用ください。エンジンがリクエストを拒否した検証失敗では残高は消費されません。