Pythonでcalendar.timegm()とtime.mktime()の違いを比較する方法

Pythonの日付・時刻関連の関数やモジュールは、特に明示されていない限り、すべてローカルタイムゾーン（現地時間）を前提として動作します。

この前提が、time.mktime()とcalendar.timegm()の挙動の違いを生み出しています。両者の違いは以下の通りです。

• time.mktime(): 引数に渡された時刻タプルをローカルタイムとして解釈します。
• calendar.timegm(): 引数に渡された時刻タプルをGMT/UTC（協定世界時）として解釈します。

同じタプルでも、タイムゾーンの解釈が異なるため、それぞれ別の時刻を表すことになります。そして、エポック（1970年1月1日0時0分0秒UTC）からの経過秒数はUTC基準で計算されるため、両関数は異なる値を返します。

返り値の差からタイムゾーンオフセットがわかる

2つの関数が返す値の差は、お使いの環境のローカルタイムゾーンのUTCからのオフセット（時差）と一致します。これを利用すれば、実行環境のタイムゾーン設定を確認することもできます。

サンプルコード

import calendar
import time
from datetime import datetime

dt = datetime(2017, 12, 31)
print(time.mktime(dt.timetuple()))
print(calendar.timegm(dt.timetuple()))

実行結果

上記のコードを実行すると、次のような出力が得られます。

1514658600.0
1514678400

この例では、2つの値の差は19,800秒（5時間30分）です。これは、実行環境のタイムゾーンがUTC+5:30（インド標準時など）であることを示しています。つまり、datetime(2017, 12, 31)という同じ日時でも、ローカルタイムとして扱うか、UTCとして扱うかによって、エポックからの秒数が異なるというわけです。

使い分けのポイント

• ユーザーの現地時間を基準にUNIXタイムスタンプへ変換したい場合は time.mktime()
• タイムゾーンに依存せず、UTCとして一貫して処理したい場合は calendar.timegm()

サーバー間やシステム間で日時データをやり取りする際は、タイムゾーンの解釈ミスによるバグを防ぐため、UTCベースのcalendar.timegm()を使うか、datetimeオブジェクトに明示的にタイムゾーン情報を持たせることをおすすめします。