トップ差分一覧ソース検索ヘルプ PDF RSS ログイン

日付と時刻.py

Python独自の日付と時刻モジュール：datetime

普通はこれだけでカレンダー計算などができる。
datetime.datetime名前空間に関数が用意されている。
datetimeはオブジェクトモジュール。

datetime.datetimeで日時を得るには、today()またはnow()を使う。
違いは、now()は引き数にタイムゾーンオブジェクトを指定できる、というだけ。

datetime.datetimeからnow()やtoday()でdatetimeオブジェクトを取得できる。datetimeオブジェクトからは、date()やtime()でそれぞれdateオブジェクト、timeオブジェクトを派生させることができる。

任意のdatetime、date、timeオブジェクトを作るには。

dt = datetime.datetime(2008, 10, 3, 9, 41, 30, 1000)
# 年、月、日が最低あれば作成可能。

d = datetime.date(2008, 10, 3)
# 年月日の3つが必ず必要。

t = datetime.time(9, 42, 15)
# 時だけで作成可能。

datetimeの差分計算

あるdatetimeから x日後・日前、y時間後・時間前などの計算を行うためには、datetime.timedeltaを使う。

datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)

h9 = datetime.timedelta(hours=9)
utcnow = datetime.datetime.now() - h9

datetime同士の計算

datetimeオブジェクト同士を計算すると、TimeDeltaオブジェクトが返される。

dt_now = datetime.datetime.now()
dt_2000start = datetime.datetime(2000, 1, 1, 0, 0, 0)
dt_delta_since_2000 = dt_now - dt_2000start
print(type(dt_delta_since_2000))

TimeDeltaオブジェクトはtotal_seconds()メソッドで総秒数になおせる。
TimeDeltaはDateTimeオブジェクト同士の「差分」なので「時間の長さ」を表す。ある時点の時刻を表すDateTimeとは違うものなので、互いに変換はできない。その必要もない。

UNIX時間を扱う：time

timeは数値と日付時刻を相互変換するモジュール。

time.time(): UNIX時間を数値で返す。
time.localtime(): UNIX時間の数値をstruct_time型で返す。
time.mktime(): struct_time型をUNIX時間の数値に変換する。

日時フォーマット

datetime.datetime.strftime(format_string)

datetime.datetime.strptime(datetime_string, format_string)

strftimeは、datetime型を文字列型に変換する。
strptimeは逆に、日時文字列をdatetime型に変換する。strptimeでは第2引数のフォーマット文字列指定は必須。

フォーマット指定子の一覧：
%a Weekday as locale’s abbreviated name.
%A Weekday as locale’s full name.
%w Weekday as a decimal number, where 0 is Sunday and 6 is Saturday.
%d Day of the month as a zero-padded decimal number.
%b Month as locale’s abbreviated name.
%B Month as locale’s full name.
%m Month as a zero-padded decimal number.
%y Year without century as a zero-padded decimal number.
%Y Year with century as a decimal number.
%H Hour (24-hour clock) as a zero-padded decimal number.
%I Hour (12-hour clock) as a zero-padded decimal number.
%p Locale’s equivalent of either AM or PM.
%M Minute as a zero-padded decimal number.
%S Second as a zero-padded decimal number.
%f Microsecond as a decimal number, zero-padded on the ~~left~~ right.
%z UTC offset in the form +HHMM or -HHMM (empty string if the the object is naive).
%Z Time zone name (empty string if the object is naive).
%j Day of the year as a zero-padded decimal number.
%U Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0.
%W Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0.
%c Locale’s appropriate date and time representation.
%x Locale’s appropriate date representation.
%X Locale’s appropriate time representation.
%% A literal '%' character.