タイムゾーン変換：pandas Timestamp vs. dt.tz_localize vs. dt.astimezone

pandas.Timestamp.tz_convertの使い方

タイムゾーン変換の必要性

データを分析する場合、データが保存されているタイムゾーンと分析するタイムゾーンが異なる場合があります。異なるタイムゾーンで保存されたデータを比較したり、分析したりするには、タイムゾーンを変換する必要があります。

tz_convert メソッドは、以下の引数を受け取ります。

• tz: 変換後のタイムゾーン

# タイムゾーンを変換する
timestamp = pd.Timestamp('2023-03-08 03:45:00')
new_timestamp = timestamp.tz_convert('Asia/Tokyo')

print(timestamp)
# 2023-03-08 03:45:00+0000

print(new_timestamp)
# 2023-03-08 12:45:00+0900

注意点

• tz_convert メソッドは、タイムゾーン情報を変更するだけです。時間は変更されません。
• 変換後のタイムゾーンが有効なタイムゾーンであることを確認する必要があります。

pandas.Timestamp.tz_convertのサンプルコード

異なるタイムゾーン間の変換

# UTCから日本時間への変換
timestamp = pd.Timestamp('2023-03-08 03:45:00+0000')
new_timestamp = timestamp.tz_convert('Asia/Tokyo')

print(timestamp)
# 2023-03-08 03:45:00+0000

print(new_timestamp)
# 2023-03-08 12:45:00+0900

# 日本時間からUTCへの変換
timestamp = pd.Timestamp('2023-03-08 12:45:00+0900')
new_timestamp = timestamp.tz_convert('UTC')

print(timestamp)
# 2023-03-08 12:45:00+0900

print(new_timestamp)
# 2023-03-08 03:45:00+0000

特定のタイムゾーンへの変換

# タイムゾーンリスト
timezones = pytz.all_timezones

# 特定のタイムゾーンへの変換
timestamp = pd.Timestamp('2023-03-08 03:45:00')
new_timestamp = timestamp.tz_convert(timezones[100])

print(timestamp)
# 2023-03-08 03:45:00+0000

print(new_timestamp)
# 2023-03-08 10:45:00-0400

タイムゾーン情報の取得

# タイムゾーン情報
print(timestamp.tzinfo)
# <DstTzInfo 'Asia/Tokyo' LMT+0900:00 STD>

# タイムゾーン略称
print(timestamp.tz)
# Asia/Tokyo

# タイムゾーンオフセット
print(timestamp.utcoffset())
# datetime.timedelta(seconds=32400)

タイムゾーンの変更

# タイムゾーンの変更
timestamp = timestamp.tz_localize('UTC').tz_convert('Asia/Tokyo')

print(timestamp)
# 2023-03-08 12:45:00+0900

無効なタイムゾーン

# 無効なタイムゾーン
try:
    timestamp.tz_convert('invalid_timezone')
except pytz.UnknownTimeZoneError:
    print('無効なタイムゾーン')

• pandas.Timestamp 型のタイムゾーン変換には、tz_convert メソッド以外にも dt.tz_localize メソッドや dt.astimezone メソッドなどがあります。
• 詳細については、pandasのドキュメントを参照してください。

pandas.Timestamp.tz_convert 以外のタイムゾーン変換方法

dt.tz_localize

# タイムゾーン情報を追加
timestamp = pd.Timestamp('2023-03-08 03:45:00')
new_timestamp = timestamp.tz_localize('Asia/Tokyo')

print(timestamp)
# 2023-03-08 03:45:00

print(new_timestamp)
# 2023-03-08 03:45:00+0900

dt.astimezone メソッドは、タイムゾーンを変換して新しい Timestamp 型を作成するために使用されます。tz_convert メソッドと異なり、元の Timestamp 型は変更されません。

# タイムゾーンを変換
timestamp = pd.Timestamp('2023-03-08 03:45:00+0000')
new_timestamp = timestamp.astimezone('Asia/Tokyo')

print(timestamp)
# 2023-03-08 03:45:00+0000

print(new_timestamp)
# 2023-03-08 12:45:00+0900

pytz ライブラリを使用して、タイムゾーン変換を行うこともできます。

from pytz import timezone

# タイムゾーンを変換
timestamp = pd.Timestamp('2023-03-08 03:45:00')
new_timestamp = timezone('Asia/Tokyo').localize(timestamp)

print(timestamp)
# 2023-03-08 03:45:00

print(new_timestamp)
# 2023-03-08 03:45:00+0900

pandas.Timestamp 型のタイムゾーン変換には、tz_convert メソッド以外にもいくつかの方法があります。それぞれの方法の特徴を理解して、状況に応じて使い分けてください。