date_range 2つの日付間の日数計算 star

日数の差はどのように計算される?

「2つの日付の間の日数」を計算するのは単純な引き算のように見えますが、カレンダーは均一ではありません。月は28日から31日まで幅があり、うるう年のルール自体も3段階になっています——4で割り切れる年はうるう年ですが、100でも割り切れる場合はうるう年ではなく、さらに400でも割り切れる場合はやはりうるう年になります。だからこそ2000年はうるう年で、1900年はうるう年ではなく、2024年はうるう年なのです。正しい日数計算アルゴリズムは、各日付を絶対的な通し日数に変換し(間に含まれるすべてのうるう年を考慮したうえで)、それらを引き算します。月と余りを手作業で足し合わせようとはしません。

具体例:2024年1月1日から2024年3月1日までは59日ではなく60日です。これは2024年がうるう年であり、この範囲に2月29日が含まれるためです。うるう年ではない2023年の同じカレンダー範囲は59日しかありません。このツールは合計を「週+日」の数値と「年-月-日」の内訳にも分解し、1か月あたり平均30.44日というような大まかな近似値ではなく、各単位に同じカレンダーを考慮したロジックを適用します。

知っておくべきこと

• 両端ではなく夜の数を数えます: 数えるのは2つの日付の間の夜の数です——1月1日から1月31日までは30日です。法律上・契約上の期限の中には両端を含めて数えるものもあります。ご自身のケースがそれに当てはまる場合は、結果に1を加えてください。
• うるう年は自動的に処理されます: 計算は常に実際のカレンダー上の日付から行われるため、2月29日や4/100/400のルールは、あなたが手動で確認しなくても適用されます。
• 日付の順序は関係ありません: 2つの日付はどちらの順で入力しても構いません——どちらを先に置いたかに関わらず、ツールは絶対的な差を表示します。
• カウントダウンにも経過日数にも使えます: 2つの日付のうち一方を今日に設定すれば、同じ合計日数の値を使って、未来のイベントまでの「残り日数」または過去のイベントからの「経過日数」を得られます。
• 月と年の長さは一定ではありません: 年-月-日の内訳は、固定の「1か月=30日」という近似値を使いません——実際のカレンダー月をたどるため、1月15日から4月15日までの期間は、その間の月が28日、30日、31日のいずれであっても、正確に3か月になります。

このカレンダーを考慮したアプローチこそが、法律や金融に関わるあらゆる場面でこのツールが信頼できる理由です——正確な日数で数えられる通知期間、購入日から計算される保証期間、あるいは日単位で確認しなければならないビザの有効期間などです。「だいたい1か月」「およそ90日」といった大まかな見積もりは、気軽な計画には十分ですが、期限、違約条項、資格の締め切りは通常、近似値ではなく正確なカレンダー上の日数に左右されます。この種の計算ツールは、まさにそのギャップを埋めるために作られています。