Python Pandas入門：POSIXタイムスタンプからナイーブなUTC日時を作成する方法

POSIXタイムスタンプ（UNIXエポックからの経過秒数）から、タイムゾーン情報を持たない「ナイーブ（naive）」なUTC日時オブジェクトを作成したい場合があります。Pandasでは、Timestamp.utcfromtimestamp()メソッドを使うことで簡単に実現できます。このメソッドの引数にはPOSIXタイムスタンプを渡します。

必要なライブラリのインポート

まず、必要なライブラリをインポートします。

import pandas as pd

Timestampオブジェクトの作成

次に、日時文字列からTimestampオブジェクトを作成します。

timestamp = pd.Timestamp('2021-09-14T15:12:34.261811624')

POSIXタイムスタンプからUTC日時への変換

utcfromtimestamp()メソッドを呼び出し、引数としてPOSIXタイムスタンプを渡すことで、ナイーブなUTC日時が生成されます。ここでは例として「1631717502」というタイムスタンプを使用します。

timestamp.utcfromtimestamp(1631717502)

サンプルコード

以下に完全なコード例を示します。

import pandas as pd

# Timestampオブジェクトを作成
timestamp = pd.Timestamp('2021-09-14T15:12:34.261811624')

# Timestampを表示
print("Timestamp...\n", timestamp)

# POSIXタイムスタンプからナイーブなUTC日時を作成
# 引数にPOSIXタイムスタンプを渡す
print("\nConstruct UTC Datetime...\n", timestamp.utcfromtimestamp(1631717502))

実行結果

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

Timestamp...
 2021-09-14 15:12:34.261811624

Construct UTC Datetime...
 2021-09-15 14:51:42

ポイント解説

「ナイーブな日時」とは、タイムゾーン情報（tzinfo）を持たないdatetimeオブジェクトのことです。utcfromtimestamp()は、指定されたPOSIXタイムスタンプを協定世界時（UTC）として解釈し、タイムゾーン情報なしの日時オブジェクトを返します。そのため、タイムスタンプ「1631717502」は「2021-09-15 14:51:42」というUTC基準の日時に変換されています。タイムゾーンを意識した処理が必要な場合は、tz_localize()やtz_convert()などのメソッドと組み合わせて使用するとよいでしょう。