開發者工具·Unix時間戳轉換器
秒還是毫秒?區分 10 位元數位紀元和 13 位元數位紀元
· 工作原理
二. 出版人 ToolAcre · 編輯审查
時間戳 unix 時間 開發人員工作流程

您今天遇到的大多數紀元值要么是十位數字(秒),要么是十三位數字(毫秒),猜錯了會將日期推後數萬年。這篇文章解釋了數字計數背後的算術,以及為什麼轉換器應該宣告單位而不是推斷單位。
1700000000 或 1700000000000? —同一時刻有兩種寫法,儀表板顯示遙遠未來的日期
日誌值 1700000000 和有效負載值 1700000000000 可以描述相同時刻。將第一個視為毫秒,您的儀表板將進入一月 1970;將秒視為秒,其日期會跳到數千年後的未來。時間戳只是一個計數加上一個單位和起點,因此沒有檔案的名為created_at的資料庫列省略了重要資訊。
為什麼當前秒計數有十位數字 - 2001 中的十億秒,十位數範圍執行到 2286,以及九位數字的含義
Unix 時間依照通常的 POSIX 約定計算從 1970-01-01 00:00:00 UTC 開始經過的秒數。 2001 中的計數器突破了 10 億;對於當代的正日期,它通常是十位小數。它保持十位數,直到在 2286 中達到 100 億。這是十進位表示法的屬性,而不是 ISO 日期字串中的規則。紀元之前的負值和遠遠超出目前的日期會使簡單的數字計數捷徑無效。
為什麼毫秒數有 13 — 一千的因數、三位額外數字,以及 JavaScript 和 Java 約定的來源
JavaScript Date.getTime() 依照慣例計算毫秒,將秒時間戳記乘以 1,000。三個零使目前的十位數秒計數變成十三位數毫秒計數。例如 1,700,000,000 秒變成 1,700,000,000,000 毫秒;兩者都是 2023-11-14T22:13:20.000Z。僅插入分隔符號而不說明假定單位的轉換器可能會將有效數字轉換為看似合理但錯誤的日期。
猜測出錯的地方 — 紀元附近的小值、2001 年之前的日期以及數字計數不再區分的未來日期
氣壓下降接近 1970 當一毫秒值可能較短時, 在 2001 當秒數少於十位數時,或帶有微秒和納秒計數器. ToolAcre 默認解釋下方的星等 10¹¹ 以秒和較大值為毫秒,並標出單位所使用的標籤。 這一門檻是一個實際的猜測,而不是一個明確的格式解碼器。 由特定設備提供的時間戳 API 應使用下列方法解釋: API即使長度不同尋常.
工作範例:一個日誌中的三個值 — 1700000000、1700000000000 和 1700000000000000,以秒、毫秒和微秒為單位讀取
說明性日誌中的三個整數顯示了該陷阱。將 1700000000 解釋為秒,將 1700000000000 解釋為毫秒:兩者都解析為 2023-11-14T22:13:20Z。將 1700000000000000 解釋為微秒並除以一百萬以獲得相同的秒計數。 ToolAcre 轉換器接受秒或毫秒,而不是微秒模式:貼上第三個數字而不先轉換其單位將無法確認預期的時刻。調試時始終將原始欄位及其單元放在一起。
為什麼應該說明單位,而不是猜測單位 - 轉換器如何顯示它所應用的單位,以便錯誤的假設是可見的而不是沉默的
發送時間戳記的服務應在其架構中命名該單元,或使用帶有明確偏移量的 ISO 8601 文字。如果遺留欄位未記錄,請在做出決定之前將多個值與另一個可靠事件時間進行比較;單一的巧合可信日期不足以作為證據。轉換器顯示它所應用的單位,讓您有機會發現 1,000 的錯誤。明確更改單位並進行比較,而不是依賴自動猜測作為長期 API 合約。
這不包括什麼 - 時間戳存儲為字串,ISO 8601 文字或電子表格序列日期,這是不同的問題
本文不解釋 Excel 序列日期、2026-09-28T10:15Z 等字串或本地時鐘讀取的時區格式。這些是不同的表示。 Unix時間戳指的是一個瞬間;同一時刻在不同區域顯示為不同的掛鐘時間。閏秒約定也值得單獨處理,並且 32 位元有符號計數器在 2038 年有溢位問題,這與秒與毫秒的問題不同。
重點:計算數字,然後確認單位 - 以及 Unix 時間戳轉換器如何讀取帶有單位標籤的秒和毫秒
計數數字作為初始提示,然後確認生產者規定的單位和至少一個已知事件。 Unix 時間戳轉換器使應用的秒/milliseconds 假設可見,並在瀏覽器中列印 UTC 和本機表示。不要讓看起來整潔的日期覆蓋產生該值的系統中相反的檔案。