2025.08.16

Pythonのエポックミリ秒入門｜取得・変換コードと注意点

saratogax

記事内に商品プロモーションを含む場合があります

エポックミリ秒は、UNIX時間（1970年1月1日 00:00:00 UTCからの経過時間）をミリ秒単位で表したもの。

ログやAPIのタイムスタンプ、IoTデータなどで広く利用されており、エンジニアなら一度は触れる形式でしょう。

ここではPythonでの取得・変換方法を、すぐ使えるサンプルとあわせて紹介します。

「エポックミリ秒」から「日時」への変換ツールも作ってみましたので、興味のある方は使ってみてください。

エポックミリ秒とは？

エポックミリ秒は、UNIX時間をミリ秒単位で表現した形式です。

秒単位のUNIX時間より1000倍の精度を持ち、リアルタイム性の高い処理に適しています。

例えば以下のような用途で見かけることが多いでしょう。

ミリ秒単位で管理することで、時刻の衝突や曖昧さを減らすことができます。

Pythonでは、time.time()を使ってUNIX時間を取得し、1000倍すればミリ秒になります。

import time
ms = int(time.time() * 1000)
print(ms)  # 例: 1723812345678

この方法はシンプルで高速ですが、値はシステムクロック依存。

より精度が必要な場面では、time.time_ns()からナノ秒を取得し、整数除算でミリ秒に変換すると良いでしょう。

取得したミリ秒を人間が読める形に直すには、秒単位に変換してdatetimeモジュールを利用します。

import datetime
ms = 1692105600000
dt = datetime.datetime.fromtimestamp(ms / 1000)
print(dt)  # 2023-08-15 09:00:00

fromtimestamp()はローカル時刻を返します。

UTCが必要な場合はutcfromtimestamp()を選びましょう。

タイムゾーンを意識するなら、pytzやzoneinfoモジュールの併用が安全です。

特定の日付をミリ秒に変える場合はtimestamp()が便利です。

import datetime
dt = datetime.datetime(2025, 8, 16, 12, 0, 0)
ms = int(dt.timestamp() * 1000)
print(ms)  # 1755336000000

ただし、タイムゾーンを持たないdatetimeはローカル時間で計算されます。

UTC基準での計算が必要なら、必ずタイムゾーン付きのオブジェクトを用意しましょう。

エポックミリ秒を扱う上で特に多いのが、秒とミリ秒の取り違えです。

10桁なら秒、13桁ならミリ秒と覚えると間違いを減らせます。

また、以下の点にも注意しましょう。