可靠的日期清單產生器技巧從三項控制開始:驗證兩個端點、使用整數的完整日數步進,以及確認步進是否恰好落在結束日期上。

日期清單產生器支援這項工作流程,可在嚴格的日曆日期端點之間,每行建立一個日期。它會將值視為日曆日期而非時間戳記,因此 UTC 偏移與日光節約時間切換不會使輸出的日期偏移。

重要的差別在於,它會產生日期序列,而非工作排程。它不會略過週末、移除假日、推算工作日,或判斷清單中的某一天是否可用。這些規則應由目標工作流程或另行的篩選步驟處理。

date list generator tips and common mistakes
日期清單產生器技巧與常見錯誤

讓日期清單精確的關鍵

先從輸入規格著手,而非想要的步進。將每個端點輸入為嚴格的 YYYY-MM-DD,也就是 HTML 日期值所使用的格式:年份 4 位數、月份 2 位數、日期 2 位數。支援的年份範圍為 0001 至 9999。縮寫年份、其他分隔符號及依語系而異的表示法,都不符合可接受的格式。

驗證器會套用每個月份的實際長度及預推西曆的閏年規則。可被 4 整除的年份為閏年,除非同時也可被 100 整除;可被 400 整除的年份仍為閏年。無效的月份數字、不存在的日期、不完整欄位,以及早於開始日期的結束日期,都會拒絕該要求。產生器不會依賴瀏覽器默默將不存在的日期轉換成下個月份的某一天。

驗證後,瀏覽器會將端點轉換為日曆日序號,並在配置輸出之前計算確切結果數量。序列從原始開始日期起,以完整日曆日向前推進,而不會在月份邊界重新開始。每個選取的日期都會轉換回來並獨立驗證。選用的星期標籤採用相同的計算方式,維持以星期一開始的固定英文名稱,且不會改變序列。

以三個受控步驟產生清單

  1. 選擇有效的邊界。 以嚴格的 YYYY-MM-DD 格式輸入開始與結束日期,並確保結束日期與開始日期相同或晚於開始日期。順序相反的範圍會遭拒絕。
  2. 輸入日數步進與標籤。 選擇 1 至 366 之間的整數間隔,以日曆日計算。若英文星期名稱有助於辨識每一行,可加以加入,然後產生完整序列。
  3. 確認端點並複製。 查看結果摘要,確認步進是否恰好落在結束日期上。將純文字輸出貼入工作流程之前,請檢查最後一行。

只有在按下按鈕後,複製控制項才會要求剪貼簿存取權限。如果權限遭拒,仍可手動選取可見的唯讀文字區塊。若某項要求會產生 10,001 個或更多日期,便會因計算數量而失敗,且不會傳回部分清單,因此不要預期產生器會保留前 10,000 列。

使步進符合間隔

步進控制的是所選日期之間的距離,而非其間的工作日數量或要求的列數。步進會直接從原始開始日期套用。

步進日曆行為典型用途
1 day從開始日期起列出每個日曆日期,但受結果數量上限限制。完整的每日涵蓋範圍
7 days建立每週序列,星期保持相同。每週計畫或固定資料
Other whole numbers from 2 through 366建立以日曆日計算的固定自訂間隔。規律的非每月週期

例如,以 1 月 30 日開始並使用兩天步進,會產生 1 月 30 日、2 月 1 日、2 月 3 日,依此類推。間隔會跨越月份邊界,不會對齊月份的第一天,也不會在特定星期重設。

七天的步進能保留星期,因為西曆的一週包含 7 個連續的日曆日。非以 7 為基礎的自訂間隔可能會改變星期。工具不支援按月或按年步進,因為 1 月 31 日及 2 月 29 日等日期需要另行制定溢位政策;如需進行日曆月份或日曆年份運算,請使用專用的日期加減計算器。選擇 30 days 指的是精確的 30 個日曆日,而非每月一次。

匯入前確認端點

將結束日期視為合格的端點,而非保證會出現在最後一列。結果摘要會報告所選步進是否恰好落在該日期上。如果最後一個選取日期出現在結束邊界之前,表示清單已刻意停止;產生器不會延長最後一個間隔、捨入至結束日期,也不會附加不符合步進的日期。

加入星期標籤只會改變顯示的行。匯入前,請將第一行與最後一行和端點摘要進行比較。如果必須包含結束日期,但間隔並未落在該日期上,請謹慎變更步進或邊界,不要在未記錄決策的情況下直接編輯產生的清單。

執行最終的輸入與輸出檢查

使用這份檢查清單,找出最容易產生誤導性日期清單的狀況。

檢查項目可接受的規則應避免的錯誤
日期格式嚴格的 YYYY-MM-DD,年份範圍為 0001 至 9999使用縮寫日期或依語系而異的日期
日曆有效性各月實際長度及西曆閏年規則預期不存在的日期會自動順延
範圍順序結束日期與開始日期相同或晚於開始日期提交遞減範圍
日數間隔1 至 366 之間的整數使用零、小數或超過上限的值
結果大小計算數量為 10,000 或更少假設超出上限的要求會傳回範例
端點對齊包含開始日期;只有完全相符時才會出現結束日期預期每份清單都包含兩個端點

悄悄改變結果的錯誤

大多數日期清單錯誤都源自產生器刻意不作的假設。在依賴輸出之前,值得檢查的是以下這些錯誤。

  • 使用熟悉的本地日期格式。 可接受的解析器刻意與語系無關。依作業系統顯示格式輸入日期,並不能取代必要的 YYYY-MM-DD 格式。
  • 假設結束日期一定會存在。 包含兩端的範圍並不表示每個間隔都會落在邊界上。開始日期一定會出現,但只有在步進準確到達結束日期時,結束日期才會出現。
  • 將「日」解讀為「工作日」。 每個步進計算的都是日曆日。由於工具不具備略過週末、計算工作日或假日日曆的功能,因此週末與假日都會保留在清單中。
  • 使用日數模擬每月重複。 30 天步進與日曆月份是不同的規則。產生器僅支援完整日數間隔,因此無法判斷溢位日期應如何推進。
  • 將星期標籤視為可用性訊號。 選用標籤會描述日曆日期,但不會顯示營業時間、市場交易時段、地區假日,也不會顯示預約是否實際可訂。
  • 預期清單會受到限制或取樣。 建立輸出之前,系統會計算確切結果數量。超過上限的要求會完全失敗,而不會傳回縮短的序列、省略符號或取樣列。

為目標用途準備純文字

結果維持純文字格式,每行一個選取的日期。啟用星期標籤時,每行也會顯示對應的英文星期名稱。你可以將文字複製到試算表、排程草稿、測試資料、內容計畫或其他本機工具中。

如果下一個目的地是 Excel,請參閱在 Excel 中不使用公式建立日期清單的配套指南,了解專屬於試算表的工作流程。貼上任何產生的清單後,請檢查第一個與最後一個日期、列數,以及目的地是否將值保留為文字,或將其解讀為本地日期和時間值。

當排程需要稽核軌跡時,請將端點與所選步進與匯入的清單一併保留。所有解析、計數、星期計算、格式化及複製作業都在目前的瀏覽器分頁中執行。小工具不會上傳或儲存任何日期範圍。

了解結果無法判斷的事項

此產生器不是預約排程器、工作日計算器、假日日曆、重複規則引擎或時區轉換器。它不知道營業時間、市場交易時段、宗教日曆、學校行事曆、地區假日、閏秒或使用者所在位置。

每日清單並不能證明清單中的每一天都可用或正常運作。匯入前,請依目標系統的規則檢查序列,尤其是在涉及截止期限、薪資、旅遊、財務或法律義務時。

相關閱讀:出生日期清單產生器:序列或隨機?。