Python の日付と時刻のフォーマット

Python で日付と時刻を扱うための基本的なモジュールは datetime です。

ここでは datetime オブジェクトを取得してから、それを任意の日付あるいは時刻にフォーマットして出力する方法について紹介します。

ついでに、datetime でタイムゾーンを扱うときの注意点についても説明します。

Python の strftime による日付と時刻のフォーマット

datetime オブジェクトをフォーマットして出力するには、strftime 関数が使えます。 strftime 関数に任意のフォーマット文字列を渡すことで、同じ datetime オブジェクトから様々の形にフォーマットすることができます。

2桁表示でゼロ埋めにしない方法

上記のフォーマット文字で二桁表示のところは全て律儀に、左側ゼロ埋めで二桁で表示されます。例えば 4月を表す場合に %m とすると 04 となります。

もし 04 ではなく 4 としたい場合は、%-m のようにハイフンを付けます。

pytz のインストール

Python でタイムゾーンを利用する場合は、 pytz モジュールを利用するのが便利です。pytz を使うとタイムゾーンの標準のデータベースである tz database を使えるようになります。

pytz はpip でインストールできます。

pip install pytz

datetime にタイムゾーンを設定する

datetime にタイムゾーンを設定する場合は、datetime 関数の tzinfo パラメータで設定すると、 タイムゾーンが LMT になりオフセットが一般的な形で返りません。

この場合は pytz の localize 関数でオブジェクトを再作成すると、一般的な形で取得できます。下記のサンプルコードをみてください (下記サンプルコードの9-10行目)。

Python の日付と時刻のフォーマットのサンプルコード

以上で説明したフォーマット文字とタイムゾーンを使った例を示します。ついでにタイムスタンプも取得しています。

print() の横に記載したコメントに出力を記載しました。

from datetime import datetime
import pytz

# Timezone
tz = pytz.timezone('America/Los_Angeles')
# tz = pytz.timezone('Japan')

# datetime(year, month, day, hour, min, sec)
dt = datetime(2017, 4, 30, 14, 30, 45)
d = tz.localize(dt)

# Year (%y, %Y)
print(d.strftime('%y\t%Y'))  # 17	2017

# Month (%B, %b, %m)
print(d.strftime('%B\t%b\t%m\t%-m'))  # April	Apr	04	4

# Weekday (%A, %a, %w)
print(d.strftime('%A\t%a\t%w'))  # Sunday	Sun	0

# Week Number (%U, %W)
print(d.strftime('%U\t%W'))  # 18	17

# Day (%d)
print(d.strftime('%d\t%-d\t%j'))  # 30	30	120

# Hour (%H, %I)
print(d.strftime('%H\t%I\t%-I\t%p'))  # 14	02	2	PM

# Min, Sec, micro-sec (%M, %S, %f)
print(d.strftime('%M\t%S\t%f'))  # 30	45	000000

# Timezone (Timezone name, UTF offset)
print(d.strftime('%Z\t%z'))  # PDT	-0700

# Timestamp
ts = int(d.timestamp())
print(f'Timestamp {ts}')  # Timestamp 1493587845

# "appropriate" representation
print(d.strftime('%c'))  # Sun Apr 30 14:30:45 2017
print(d.strftime('%x %X'))  # 04/30/17 14:30:45

######################################
# US Common
print(d.strftime('%-m/%-d/%Y %-I:%M %p'))  # 4/30/2017 2:30 PM
# ISO8601
print(d.strftime('%Y-%m-%dT%H:%M%z'))  # 2017-04-30T14:30-0700

以上、datetime を自在にフォーマットする方法について説明しました。