單位錯誤時,時間設定會悄悄出錯

30000、60、3600 這類設定值,若不知道預期單位就會含糊不清。逾時可能是毫秒、快取 TTL 可能是秒、監控間隔可能是分鐘。

如何換算毫秒、秒、分鐘與小時:用於逾時與 TTL 設定

如何換算毫秒、秒、分鐘與小時:用於逾時與 TTL 設定

時間單位換算工具 可換算毫秒、秒、分鐘、小時與天,讓你在設定變成 bug 之前先行檢查。

範例:讓設定值可供審查

假設某個 API client 的設定含有這些值:

const apiClient = {
  timeout: 30000,
  retryDelay: 1500,
  cacheTtl: 86400,
};

只看數字很難判斷,但統一單位後就好審查了。

設定 原始值 讀作
timeout 30000ms 30 秒
retryDelay 1500ms 1.5 秒
cacheTtl 86400秒 24 小時

像這樣換算後再看,團隊就能討論 API 逾時是否合理、重試間隔是否太短、快取是否該保留到隔天。

常見換算

30000ms 是 30 秒。5 分鐘 是 300 秒或 300000 毫秒。3600 秒 是 1 小時。審查時把這些值寫成易讀形式,更容易發現設定錯誤。

結合時長與時鐘時間

當你需要知道某個時間戳何時到期,請將時長換算與 Unix 時間戳轉換工具 或 UTC 與 JST 時區轉換工具 結合。這有助於把 TTL 與權杖到期值換算成實際的日曆時間。

常見的混淆

單位並不一致。Node.js 的部分 API 與瀏覽器的 setTimeout 使用毫秒,Redis 的 EX 使用秒,監控服務的設定畫面則可能以分鐘為單位。尤其 60 這個值,可以是 60 毫秒、60 秒或 60 分鐘,因此在註解或設定名稱中標明單位,日後閱讀會輕鬆許多。

API_TIMEOUT_MS=30000
CACHE_TTL_SECONDS=3600
JOB_INTERVAL_MINUTES=5

在環境變數名稱中加入單位,並用工具換算成實際時間後再審查,就算只看設定檔的人也能理解意圖。

常用換算速查表

這裡整理審查設定值時最常出現的換算,心算拿不準時可用來核對。

時間 秒 毫秒
1 秒 1 1,000
1 分鐘 60 60,000
5 分鐘 300 300,000
1 小時 3,600 3,600,000
1 天 86,400 86,400,000

例如看到 86400 就能立刻想到「1 天」,就能當場判斷快取 TTL 是否比預期更長。300(5 分鐘)與 3600(1 小時)也常見於監控間隔與權杖有效期限。

這個工具的換算範圍與實際顯示

單位有 毫秒、秒、分、小時、天、週 六種。月與年因為長度不固定,所以不包含在內。輸入一個數值與單位,就會同時顯示所有單位的值。

輸入 顯示的結果(節錄)
90 分鐘 5400000 毫秒 / 5400 秒 / 1.5 小時 / 0.0625 天 / 0.008929 週
1.5 小時 90 分鐘 / 5400 秒 / 0.0625 天
0.1 秒 100 毫秒 / 0.001667 分鐘 / 2.777778e-5 小時

顯示規則是小數四捨五入到 6 位,除不盡的值會顯示得較短。另外,非常小的值(小於 0.0001)或 10 億以上的值,會以 2.777778e-5 這樣的指數表示。出現指數表示時,代表該單位「位數差太多」。改用位數相近的單位來讀取數值,可以減少看錯設定值的機會。

也可以用文字輸入期間。它能讀取 1h30m、1d 2h、250ms 這類帶單位的寫法、01:30:00(時:分:秒)的時鐘寫法,以及 ISO 8601 的 PT1H30M,轉成毫秒後換算成所有單位。結果下方會顯示像 1h 30m / PT1H30M 這樣易讀的表示法與 ISO 8601 表示法。沒有單位的純數字(90)無法判斷是分鐘還是秒,因此不會讀取;年與月(P1Y、P1M)因長度不固定也不會讀取。

總結

毫秒與秒容易混淆。在貼進設定前先換算數值,並務必確認函式庫、API 或雲端服務所預期的單位。

常見問題

30000 這個值是毫秒還是秒?

取決於情境。部分 Node.js API 與瀏覽器的 setTimeout 使用毫秒,所以 30000 是 30 秒;而 Redis 的 EX 是以秒為單位。同樣的「timeout」會因函式庫或服務而異,因此請在文件中確認單位,並用 時間單位換算工具 換算成易讀的單位。

如何避免混淆單位?

在設定名稱或環境變數名稱中包含單位。API_TIMEOUT_MS、CACHE_TTL_SECONDS、JOB_INTERVAL_MINUTES 即使只看到值也能傳達意圖。60 這類值尤其有風險,因為它可能是 60 毫秒、60 秒或 60 分鐘。

我想知道 TTL 實際何時到期。

若要把以秒為單位的 TTL 換算成實際日期/時間,請結合 Unix 時間戳轉換工具 或 UTC 與 JST 轉換工具 來查看具體的到期時刻。

有沒有記住常見秒數意義的訣竅?

記住常出現的數值,判斷就會變快。300 是 5 分鐘、3600 是 1 小時、86400 是 1 天、604800 是 1 週,是最具代表性的幾個。它們常見於監控間隔、權杖有效期限與快取 TTL,以此為基準,再以「是它的幾倍」來思考,就容易抓到大概的數量級。