Blog

Unixタイムスタンプを日本時間で読み、ログ検索の開始値を作る

架空のAPIログを使い、Unixタイムスタンプのミリ秒を日本時間とUTCに変換する。日本時間の午前0時を起点にログを探すため、日時からUnix秒とミリ秒を求める手順も、操作画面付きで紹介する。

英語版のUNIX時間変換で、ログのミリ秒を日本時間とUTCに変換した結果

「日本時間で1月1日の午前0時ごろ」に起きた処理を調べたい。手元にあるのは、時刻が 1735657200125 と記録されたAPIログである。UNIX時間変換を使い、この記録が日本時間でいつなのかを確かめ、同じ時刻帯をログ検索に指定するための開始値を作る。例のログは架空のものだ。

ログのミリ秒を日本時間とUTCで読む

  1. APIの項目仕様を開き、時刻がUnixミリ秒で記録されていることを確認する。
  2. 「Unixタイムスタンプ」に 1735657200125 を入力し、「入力値の単位」で「ミリ秒」(英語版は「Milliseconds」)を選ぶ。
  3. 日本時間に 2025-01-01 00:00:00.125、UTCに 2024-12-31 15:00:00.125 が表示される。どちらも同じ瞬間を指す。日本時間では年が明けて125ミリ秒後である。
1735657200125をMillisecondsで読み、日本時間に2025年1月1日、UTCに2024年12月31日が出た英語版の画面
日本時間の午前0時台は、UTCでは前日の15時台に当たる。

近年のログでは、整数のUnix秒は10桁、Unixミリ秒は13桁になることが多い。たとえば 1735657200 をミリ秒として読むと1970年1月の日付が出る。桁数は手掛かりにして、選ぶ単位はログの項目仕様で確認する。

日本時間の午前0時からログを検索する

  1. 「日時からUnixタイムスタンプへ」の「年月日と時刻」に 2025-01-01 00:00 と入力する。省略した秒は0になる。
  2. 「入力した日時のタイムゾーン」で「日本時間(UTC+09:00)」を選ぶ。結果は入力に合わせて自動で更新される。
  3. 検索欄が秒指定なら 1735657200、ミリ秒指定なら 1735657200000 を開始値に使う。開始時刻を含めて検索すると、最初に確認した 1735657200125 はその125ミリ秒後に当たる。
2025-01-01 00:00を日本標準時に設定し、1735657200秒と1735657200000ミリ秒が出た英語版の画面
同じ開始時刻が秒とミリ秒で表示される。検索欄の単位に合う方を使う。

UTCで記された時刻を入力する場合は、タイムゾーンに「協定世界時(UTC)」を選ぶ。同じ文字列でも、どちらの時計で読んだかで結果は9時間分変わる。このツールではJSTを全期間でUTC+09:00として扱い、うるう秒は扱わない。