日付計算ツールとは?
日付計算ツールは、開始日を起点として、年・月・週・日で表した期間だけ前後に移動させます。結果となるカレンダー上の日付と、それが当たる曜日を返します。
日付を手で数えるのは意外と間違いやすいものです。月ごとに日数が異なり、うるう年は4年ごとに1日を加え、週は月の境界をまたぎます。このツールはその計算を代わりに行い、実際のカレンダーを尊重するため、結果は常に有効な日付になります。
これは、日付を未来に投影したり過去にさかのぼったりする必要があるときに役立ちます。配送期間、契約更新、返品期限、あるいは単に「今日から90日後は何日か」といった場合です。
計算ツールの仕組み
このツールには3つの情報が必要です。
- 開始日 — 数え始める日付。
- 演算 — 期間を加算する(前へ進める)か、減算する(後ろへ戻す)か。
- 期間 — 適用する年・月・週・日の数。
単位は大きいものから順に適用されます。まず年、次に月、次に週、次に日です。カレンダーに沿って処理するため、結果は月の日数とうるう年を尊重します。たとえば、1月31日に1か月を加算すると、3月へ行き過ぎるのではなく2月の最終日に着地します。
移動先が存在しない日付になる場合 — たとえばうるう年の2月29日から1年を減算する場合 — 結果はその月の最後の有効な日(2月28日)に丸められます。
計算式
月や年は長さが異なるため、カレンダーの移動は単一の固定された日数ではありません。開始日 に適用される、カレンダーを意識した一連のステップとして表します。
ここで:
- = 年の数
- = 月の数
- = 週の数
- = 日の数
符号は加算のとき正、減算のとき負です。週と日は正確です。
ただし、年と月はカレンダー上の位置に依存するため、一律の日数に変換するのではなく、ステップごとに適用されます。
例
例1:日を加算する
2024-01-01 から始めて 100日 を加算します。
結果は 2024-04-10、水曜日 です。
例2:週を加算する
2024-01-01 から始めて 3週 を加算します。
結果は 2024-01-22、月曜日 です。
例3:年を加算する
2024-06-15 から始めて 5年 を加算します。
結果は 2029-06-15、金曜日 です。
例4:日を減算する
2024-04-10 から始めて 100日 を減算します。
結果は 2024-01-01、例1で開始日として使った日付と同じです。
実用的な使い方
- 締め切りと期日 — 固定の日数だけ前へ数えて何かの期日を求めたり、後ろへ数えていつ始めるべきかを知ったりします。
- サブスクリプションと契約 — 月または年で測った期間を開始日に加算して、更新日を求めます。
- 返品と保証 — 30日間の返品期間や数年間の保証期間を購入日に加算します。
- 計画 — マイルストーンを週単位で前へ投影したり、記念日を年単位で過去にさかのぼったりします。
よくある質問
このツールはうるう年に対応していますか?
はい。移動は実際のカレンダーに対して適用されるため、2024-02-28(うるう年)に2日を加算すると 2024-03-01 に着地しますが、平年では 2024-03-02 に着地します。
月が短すぎる場合はどうなりますか?
結果は対象の月の最後の有効な日に丸められます。2024年1月31日に1か月を加算すると、無効な3月の日付ではなく、2024年2月29日(そのうるう年2月の最終日)になります。
加算だけでなく期間を減算することもできますか?
はい。減算 演算を選ぶと、期間が後ろ向きに適用され、結果が時間的により前になります。
時間加算ツールとはどう違いますか?
時間加算ツールは、日付と時刻を時・分・秒だけ移動させます。このツールはカレンダー上の暦日単位で動作するため、年・月・週・日だけ移動させ、結果の日付とその曜日を報告します。