random date generator explained
隨機日期產生器詳解:如何挑選日期

隨機日期產生器實際在做什麼

隨機日期產生器透過在兩個 YYYY-MM-DD 端點之間的封閉範圍中均勻取樣來產生日曆日期,然後使用 UTC 元件(而非本地時間運算)將所選的整數日位置格式化回穩定的日期。這種做法很重要,因為日期運算其實脆弱得驚人:一個跨越日光節約時間轉換、非閏世紀(如 1900 年)或月底邊界的範圍,在使用天真的 24 小時加法實作時,可能會悄悄地產生跳過、重複或差一的日期。正確的實作方式是將嚴格的日曆輸入轉換成從 1970-01-01 起以整個 UTC 天數計算的序數位置,使用密碼學強度夠高的隨機機制抽取這些位置,並拒絕任何違反格里高利規則的輸入,而不是靜默地修復它。最終結果是一份 YYYY-MM-DD 格式的日期清單,其中每個符合資格的日曆日期被選中的機率相等,端點也包含在內,而且輸出不受你的本地時鐘或時區影響。

在這個簡單描述的背後,是一連串小決策:範圍如何以整數表示、這些整數如何在無偏差的情況下抽取、日曆規則如何強制執行,以及所選的整數如何轉回人類可讀的日期。本文的其餘部分將逐一說明這些決策,然後展示如何使用 隨機日期產生器 來實際運用它們。

天真日期運算中的日光節約時間問題

日光節約時間是日期程式碼中最常見的細微錯誤來源。當一段指令碼取得起始日期,加上 N × 24 × 60 × 60 × 1000 毫秒,然後將結果格式化,它其實假設每一天都剛好是 24 小時。在一個會實施日光節約時間的時區中,這個假設在一年中兩個轉換日當天是錯的,因此以毫秒進行的「均勻」取樣可能會落在錯誤本地日期的 23:00 或 01:00,跳過一個日曆日,或重複一個日期。當實作在本地午夜加上 24 小時時也會出現同樣的問題,因為在轉換日當天,本地午夜並不是一個固定的瞬間。

日光節約時間安全的產生器透過將每個日曆日期視為整數日位置而非時間上的某個瞬間來避免這個問題。轉換過程在 Date 物件上使用 UTC 元件:嚴格的 YYYY-MM-DD 輸入透過 setUTCFullYear、setUTCMonth 和 setUTCDate 設定,再用對應的 UTC 讀取器讀回元件,所得的 UTC 毫秒值除以剛好 86,400,000,以取得整日序數。取樣發生在這些序數上,所選的序數再用相同的 UTC 讀取器格式化回來。因為 UTC 沒有日光節約時間,每一天剛好都是 24 小時,所以一個在你時區跨越本地日光節約時間邊界的範圍,在內部仍保持一致。ECMAScript 規格 定義了這個 Date 行為,也是本文所用讀取器和設定器的參考依據。

無模數偏差的取樣

即使日期運算正確,隨機機制本身仍可能引入偏差。常見的捷徑是從瀏覽器的 Web Crypto API 讀取一個隨機的 32 位元無號整數,然後對範圍大小取模數。只要範圍大小無法整除 2^32,這個捷徑就是不均勻的,因為前段的「餘數」來源值會被映射到比其餘位置更小的輸出位置集合。對於像 3 天這樣的小範圍,偏差雖小但仍會破壞均勻性。

隨機日期產生器透過拒絕取樣消除這種偏差。它只接受大小為範圍大小整數倍的最大前綴來源區間,然後再進行模數運算。為了理解這在 3 天範圍上如何運作,可以看以下的計算:2^32 = 4,294,967,296 個來源值,而在這個上限以內能容納的 3 的最大倍數是 4,294,967,295 = 1,431,655,765 × 3。因此產生器接受 0 到 4,294,967,294 之間(含)的來源值(共 4,294,967,295 個),並拒絕那個唯一的尾端值 4,294,967,295。三個日序數各自分到剛好 1,431,655,765 個來源值,所以每個位置的機率都相同。這個方法可以擴展到任意大小的範圍。當瀏覽器反覆回傳落在拒絕尾端的值時,安全機制會回報隨機來源失敗,以保護我們不會因損壞或無法存取的熵源而悄悄退而採用有偏差的抽取。W3C Web Cryptography API 定義了提供底層無號字的 getRandomValues 呼叫。

嚴格驗證:閏年與日期溢位

驗證是拼圖的第二塊。一個鬆散的實作如果從「2025-02-30」建構日期,會靜默地把值往前捲進 3 月初,這代表一個不小心輸入的「不可能」日期可能會悄悄變成輸出中的真實日期。隨機日期產生器改為在 UTC Date 物件上設定 YYYY-MM-DD 元件,然後讀回來;如果讀回的元件與輸入不符,該項目會被拒絕,並向使用者顯示錯誤,而不是靜默修正後的值。

閏年遵循 ECMAScript Date 所實作的格里高利規則:可被 4 整除的年份是閏年,但世紀年例外,只有可被 400 整除時才是閏年。因此 2000-02-29 和 2024-02-29 是有效的,而 1900-02-29 和 2023-02-29 則會被拒絕。月份和日期的溢位也遵循同樣的嚴格路徑:2025-04-31 不能捲進 5 月,2025-13-01 也不能捲進下一年。支援的日曆範圍為 0001-01-01 至 9999-12-31。實作使用 setUTCFullYear 而非 Date.UTC 傳統的兩位數年份解讀,因此四位數的 0067 年會保持 0067,而不會被偏移成 1967 年。

輸入結果原因
2024-02-29有效2024 可被 4 整除且不是非閏世紀
2000-02-29有效2000 可被 400 整除
1900-02-29無效1900 是世紀年但無法被 400 整除
2023-02-29無效2023 無法被 4 整除
2025-04-31無效4 月只有 30 天
2025-13-01無效月份 13 超出 1–12 的範圍

如何產生隨機日期

  1. 開啟隨機日期產生器,以 YYYY-MM-DD 格式輸入有效的起始日期,例如 2024-01-01。
  2. 輸入有效的結束日期,使其與起始日期相同或更晚,例如 2024-12-31。兩個端點都符合抽取資格。
  3. 設定介於 1 到 1,000 之間的數量,反映你需要的日期筆數。空白、小數、零、負數或超出範圍的數量會產生明確的錯誤,且不會被截斷。
  4. 決定是否允許重複。當不應有任何日期出現兩次時,適合使用不重複模式;當獨立抽取可接受時,適合使用重複模式。
  5. 產生清單,確認顯示的範圍與數量符合你的輸入,然後複製或記錄這些值。
  6. 編輯任一端點、更改數量,或切換重複模式都會清除先前的清單及任何先前的錯誤,因此舊的結果不會留在畫面上,讓人誤以為符合目前控制項的狀態。

對於想要一份精簡輸入、輸出與 1,000 筆上限參考的讀者,隨機日期產生器輸入與限制速查表 將相同的操作規則集中在一處。

產生器未涵蓋的部分

輸出是一份純粹的日曆日期清單,有些相關功能刻意未納入範圍。本工具不會過濾週末、國定假日、歷史曆法轉換、組織特定的禁日或預約可用性,也不會扣除工作日或加上工作日偏移。此外,它不會輸出一天中的時刻或時區偏移;每個項目都是 YYYY-MM-DD 格式的民用日期,內部時間元件固定為 UTC 序數。對於工作日序列、感知假日的範圍,或一天中特定時刻,應使用專門的工具。

可重現性同樣依設計排除在外。Web Crypto 在這個介面上刻意不可設定種子,因此對於需要可重現抽取的軟體測試,請儲存本工具回傳的日期,或在測試工具中使用另外的種子式產生器。若抽取具有財務、法律、競賽、安全或稽核上的後果,請執行有獨立監督並保留證據的書面程序;隨機日期產生器是針對一般實用工作所做的嚴謹無偏差取樣,並非經認證的隨機抽籤服務。

為何等機率仍然可能令人意外

均勻抽樣代表每個符合資格的日期被選中的機會相同,但這並不能保證小樣本「看起來」是均勻分布的。從一年中抽出五個日期,很容易出現聚集、漏掉某個季節,或落在連續日期上,而這正是均勻隨機性所預期的結果。重複模式讓重複出現變得合情合理;如果你需要每次抽出的日期都不同,請切換到唯一模式,該模式會執行稀疏的部分 Fisher-Yates 不放回抽樣,並在要求的唯一日期數超過區間所能提供時拒絕該請求。

兩個互動表格能讓實務上的差異一目了然。重複模式獨立抽樣,並允許最多 1,000 次的任意數量;唯一模式則確保每個日期僅出現一次,並拒絕大於該含首尾區間的數量。單日區間(例如 2025-07-04 到 2025-07-04)在數量至少為 1 時,重複模式必定回傳該單一日期;而在唯一模式下,除非數量剛好為 1,否則會回傳錯誤。一開始就選對模式,能讓輸出符合預期。

面向重複模式唯一模式
抽樣方式在整個含首尾區間內獨立抽取稀疏的部分 Fisher-Yates 不放回抽樣
數量最多 1,000無論區間大小皆可僅在數量不超過區間內日期總數時適用
數量大於區間持續抽取;可預期會出現重複回報為錯誤;不會縮短清單,也不會悄悄啟用
單日區間每次抽取皆回傳該日期數量為 1 時回傳該日期一次;否則回傳錯誤
使用情境獨立樣本、重複賽程、重複練習由唯一日期組成的名單、彼此不重複的測試案例、不放回抽樣

看清楚這些機制後,模式的選擇就變得簡單明瞭:當重複可以接受或預期會發生時,選擇重複模式;當輸出應該是一份由不重複日期構成的名單時,則選擇唯一模式。無論哪種方式,背後的抽樣、驗證與 DST 處理都維持不變,這正是「完整說明」導覽的價值所在:一旦各個運作環節一目瞭然,這個工具的行為就不再是黑盒子。

延伸閱讀:隨機字母產生器完整說明:從點擊到複製。