はじめに
おつかされまです。tyamonです。
この記事では、UNIXタイムスタンプとは何かを初心者向けに解説し、日時との相互変換をブラウザだけで手軽に行う方法を紹介します。
以下のような方を対象としています。
- AWSのログやAPIレスポンスに出てくる数字（例:
1700000000）の意味がわからない - Pythonやシェルコマンドを使わず、手軽にタイムスタンプを変換したい
- ツールを探しているが、データをサーバーに送りたくない
執筆の背景
仕事でAWSのCloudWatchログやLambdaのレスポンスを確認するとき、1700000000 のような数値が出てきて「これ何時？」となることが多くありました。
毎回コマンドやWebサービスを使うのが手間だったので、自分用のブラウザツールとして作成しました。
結論（成果物）
本記事で紹介するツールを使うことで、UNIXタイムスタンプ（秒・ミリ秒）と日時文字列を、インストール不要・データ送信なしでブラウザ上で相互変換できます。
ツールはこちら → 日時・UNIX時刻変換 | tools.tyamon.com
UNIXタイムスタンプとは？
まず、UNIXタイムスタンプの基礎を押さえておきましょう。
UNIXタイムスタンプとは、1970年1月1日 00:00:00 UTC（協定世界時）を起点として、そこからの経過秒数を表す数値です。
たとえば 1700000000 は、2023年11月14日 22:13:20 UTC を意味します。
なぜ「1970年1月1日」が起点なの？
これはUNIXオペレーティングシステムが設計された時代に定められたもので、「UNIX時間の元年」 と呼ばれます。
現在もLinux・macOS・AWS・各種プログラミング言語など、ほぼすべてのシステムがこの形式を採用しています。
秒とミリ秒の違い
UNIXタイムスタンプには2種類あります。
| 種類 | 桁数の目安 | 例 |
|---|---|---|
| 秒（Unix Time） | 10桁 | 1700000000 |
| ミリ秒（Unix Time ms） | 13桁 | 1700000000000 |
JavaScriptの Date.now() はミリ秒を返しますが、AWSのIAMやLambdaは秒で返すことが多いです。
桁数で判別できるので、変換前にまず桁数を確認するのがコツです。
タイムゾーンに注意
UNIXタイムスタンプはタイムゾーンに依存しない絶対時刻です。
「9時間ずれている」と感じた場合は、UTC（世界標準時）とJST（日本標準時）の差 +9時間が原因です。
変換ツールを使う際は、表示したいタイムゾーンを必ず指定しましょう。
ツールの使い方
タイムゾーンを選ぶ
画面上部でタイムゾーンを選択します。日本時間で確認したい場合は JST (UTC+9) を選んでください。
UNIXタイムスタンプ → 日時に変換する
左側の「UNIX → 日時」エリアに、変換したいタイムスタンプを貼り付けて「変換」ボタンを押します。
- 秒（10桁）・ミリ秒（13桁）はどちらも自動判別します
- Enterキーでも変換できます
日時 → UNIXタイムスタンプに変換する
右側の「日時 → UNIX」エリアに、日時文字列を入力して「変換」ボタンを押します。
入力フォーマットの例：
2024-01-01 12:00:00「現在時刻をセット」ボタンを押すと、今の時刻が自動入力されるので便利です。
現在時刻の確認
画面中央のリアルタイム表示エリアで、現在時刻とそのUNIXタイムスタンプを1秒ごとに確認できます。
実務での活用シーン
開発・運用の現場でUNIXタイムスタンプが登場する場面をまとめました。
AWSのログ確認
CloudWatch LogsやS3のアクセスログでは、タイムスタンプが数値で記録されることがあります。
ログを調査するとき、「このエラーは何時に起きたのか」をすばやく確認するのに使えます。
APIレスポンスの確認
REST APIやGraphQL APIのレスポンスに含まれる created_at や expires_at がUNIXタイムスタンプ形式のことがあります。
値の妥当性（有効期限が正しいか、など）をすぐに確認できます。
DBのレコード確認
MySQLやDynamoDBに保存された日時カラムがUNIX時刻で格納されている場合、値の読み替えに使えます。
JWT（JSON Web Token）の有効期限確認
JWTのペイロードには iat（発行時刻）・exp（有効期限）がUNIXタイムスタンプで含まれています。
「このトークンはまだ有効か？」を確認するときに便利です。
まとめ
今回は UNIXタイムスタンプの基礎知識と、ブラウザで手軽に日時変換する方法を紹介しました。ポイントは以下の通りです。
- UNIXタイムスタンプは 1970年1月1日 UTCからの経過秒数
- 10桁が秒、13桁がミリ秒と桁数で見分けられる
- タイムゾーンの違い（UTC vs JST）に注意が必要
- tools.tyamon.com の日時変換ツールはインストール不要・データ送信なしでブラウザ完結
次のステップ
tools.tyamon.com には他にも開発作業で役立つツールを公開しています。
コメント