日曆契約

日曆日期、ISO 週年與經過時長

日期識別日曆中的一天,時間點識別時間軸上的位置,時長表示一段時間的量;三者不能互換。

內容更新: · 維護者與修正回報

計算日曆天,不假定每天都經過 24 小時

日期工具使用延伸公曆,範圍為 0001–9999 年;拒絕無效日期,不讓 Date 暗中進位成其他日期。不模擬歷史上不同曆法的切換。

日期間距與包含幾天是不同問題。計算週一至五時,請檢查起訖日期是否包含;這只排除週末。國定假日、組織行事曆與法定期限須另查權威規則。

ISO 週年不一定等於日曆年份

ISO 週從週一開始,第 1 週包含 1 月 4 日,因此跨年前後的日期可能屬於前一個或下一個週年。只有部分週年存在第 53 週,不能假設每年都有。

例如 2021-01-01 是 2020-W53-5。可用工具顯示的週一至週日範圍核對報表;財務週、在地慣例與週日起算是其他系統。

時長不在午夜歸零

總計 27 小時仍是 27 小時,不是鐘面上的 03:00。加減時請使用明示的正負號格式;分與秒須在允許範圍,任一行錯誤會阻止整筆計算。

固定時長不能表示日曆月份,也不能解決本地夏令時間變化。薪資進位、計費單位及日期運算應分開;複製總量時請一併保留單位。

2024-02-28 + 1 日曆天 = 2024-02-29
2021-01-01 = 2020-W53-5
25:00:00 + 02:30:00 = 27:30:00

資料可信度

資料來源