日期計算若要可靠，必須先明確操作模式與時間粒度
日期計算工具廣泛用於排期規劃、文件審查、交付週期檢查與基礎日曆運算。但日期問題極易被誤解，因為使用者往往會把相隔天數、日期加減、時區語義與工作日規則混合為同一種需求。要讓結果可被信任，頁面說明必須精確寫明目前工具究竟支援哪些模式、按照什麼粒度處理，以及不支援哪些進階情境。
目前日期計算器支援的模式
| 模式 | 所需鍵值 |
|---|---|
| `between` | `start` 與 `end`，格式為 `YYYY-MM-DD` |
| `add` | `start` 加上數值型 `days` |
| `subtract` | `start` 減去數值型 `days` |
如何使用這個工具
- 先在 日期計算器 中准备一份有代表性的开始日期、结束日期、相差天数以及加减天数，不要一开始就處理最大或最敏感的真实内容。
- 执行處理流程并產生目標日期或日期差结果后，優先檢查是否包含首尾日期、周末、节假日、时区假设和跨月跨年边界，再判断结果是否真的可用。
- 只有当结果已经適合用于项目时间线、试用期、续费檢查、内容日历和截止日期规划，并且不再触发這条风险提醒时，才複製或下载輸出：工作日規則和节假日会因组织而异，正式截止时间應以权威日历為准。
日期計算器 範例
這個 日期計算器 示例使用有代表性的开始日期、结束日期、相差天数以及加减天数，展示產生后的目標日期或日期差结果，便于你先確認是否包含首尾日期、周末、节假日、时区假设和跨月跨年边界，再把同样設定用于真实輸入。
範例輸入
2026-05-15 plus 30 days
預期輸出
2026-06-14目前實作以日曆日為粒度，不處理時區、工時或工作日規則
目前工具只接受 `YYYY-MM-DD` 形式的日期輸入，並以天為最小處理粒度。在 `between` 模式下，它會計算兩個日期之間的相隔天數，並標明方向；在 `add` 與 `subtract` 模式下，它會基於起始日期做整天偏移。由於目前邏輯並未引入工作日、節假日、小時級時間戳或時區換算，因此頁面文案不應把它描述為工作日計算器、年齡計算器或完整排班引擎。
排期邊界
如果業務依賴節假日、本地工作日曆或具體時刻截點，應將本工具視為初步計算器，而不是最終排期依據。
使用注意
- 複用目標日期或日期差结果前，先檢查是否包含首尾日期、周末、节假日、时区假设和跨月跨年边界。
- 工作日規則和节假日会因组织而异，正式截止时间應以权威日历為准。
- 当结果会影响生产工作或客户可见内容时，應保留原始开始日期、结束日期、相差天数以及加减天数以便回退和核对。
日期計算器 參考說明
日期計算器 的参考說明應始终围绕开始日期、结束日期、相差天数以及加减天数、產生的目標日期或日期差结果，以及用于项目时间线、试用期、续费檢查、内容日历和截止日期规划前必须確認的檢查点。
- 輸入重点：开始日期、结束日期、相差天数以及加减天数。
- 輸出重点：目標日期或日期差结果。
- 複核重点：是否包含首尾日期、周末、节假日、时区假设和跨月跨年边界。
參考資料
常見問題
以下問題圍繞 日期計算器 的實際用途整理，重點說明輸入要求、輸出結果與常見限制。計算兩個日期之間的天數，或對起始日期加減天數。
日期計算器 最適合處理什麼樣的开始日期、结束日期、相差天数以及加减天数？
日期計算器 的核心用途是計算日期间隔或按天数推移日期。当开始日期、结束日期、相差天数以及加减天数需要快速变成目標日期或日期差结果，并继续用于项目时间线、试用期、续费檢查、内容日历和截止日期规划时，它最有价值。
複用 日期計算器 產生的目标日期或日期差结果前，最該檢查什麼？
應優先檢查是否包含首尾日期、周末、节假日、时区假设和跨月跨年边界。這些细节最能直接判断结果是否已经適合继续交给下游流程。
日期計算器 產生的目标日期或日期差结果通常會被帶到哪裡繼續使用？
最常见的下一步就是用于项目时间线、试用期、续费檢查、内容日历和截止日期规划。這類輸出是按真实交接場景来组织的，不是泛化占位结果。
什麼時候不應該直接相信 日期計算器 的結果，而要人工複核？
工作日規則和节假日会因组织而异，正式截止时间應以权威日历為准。