時間設定は、単位の取り違えで壊れやすい

アプリケーションの設定では、30000、60、3600 のような数値だけが書かれていることがあります。これがミリ秒なのか、秒なのか、分なのかを取り違えると、タイムアウトが短すぎたり、キャッシュが長く残りすぎたりします。

ミリ秒・秒・分・時間を変換する方法:タイムアウトやTTL設定の確認

ミリ秒・秒・分・時間を変換する方法:タイムアウトやTTL設定の確認

DevToolKitsの 時間単位変換ツール を使うと、ミリ秒、秒、分、時間、日を相互に変換できます。

実例:設定値をレビューできる形に直す

たとえば、APIクライアントの設定に次のような値が入っていたとします。

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

値だけを見ると判断しづらいですが、単位をそろえるとレビューしやすくなります。

設定 元の値 読み替え
timeout 30000ms 30秒
retryDelay 1500ms 1.5秒
cacheTtl 86400秒 24時間

このように変換してから見ると、APIタイムアウトは妥当か、再試行間隔は短すぎないか、キャッシュが翌日まで残ってよいかをチームで話しやすくなります。

よく確認する値

APIタイムアウトなら 30000ms = 30秒、キャッシュTTLなら 3600秒 = 1時間、監視間隔なら 5分 = 300秒 のように、人間が読みやすい単位に直してから設定値を確認するとミスが減ります。

クラウドサービスやライブラリによって、同じ「timeout」でも秒指定とミリ秒指定が混在します。ドキュメントを読むときは、値だけでなく単位まで見るのが大切です。

日時の確認と組み合わせる

「このTTLだといつ期限切れになるか」を見たい場合は、UNIXタイムスタンプ変換ツール や UTC・JST変換ツール と組み合わせると、実際の日時として把握しやすくなります。

ありがちな取り違え

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時間)は監視間隔やトークン有効期限でもよく登場する値です。

このツールの換算範囲と、実際の表示

単位は ミリ秒・秒・分・時間・日・週 の6つです。月と年は、長さが一定でないため含まれていません。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)は長さが決まらないため読み取りません。

まとめ

時間単位の変換は小さな作業ですが、設定ミスの影響は大きくなりがちです。タイムアウト、TTL、監視間隔、再試行間隔を設定する前に、期待する単位へ変換して確認しておきましょう。

よくある質問

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でよく登場するので、これらを基準に「その何倍か」で考えると見当をつけやすくなります。