6.2 組み込みモジュール time

 

このモジュールは様々な時間関連の関数を提供します。これは常に利用可能です。

用語と慣例についての説明を順に述べます。

• エポック とは時間が始まる点のことです。 その年の1月1日の午前0時には、「エポックからの時間」は0です。 Unixについてはエポックは1970年です。エポックがいつかを見付けるためには gmtime(0)で調べて下さい。

• UTCはCoordinated Universal Time(公式にはグリニッジ標準時として知られています) です。 頭字語UTCは間違いではなく英語とフランス語を折衷したものです。    

• DSTはDaylight Saving Time（夏時間）で、一年の一部の間(通常)1時間だけ時間帯を 補正することです。DSTの規則は不思議なもの(ローカルな法律で決められます)で年々 変更すること もできます。Cのライブラリはローカルな規則を含む表(柔軟性をもたせるため それはシステムファイルから読まれることが多い)を持っていて、この点では 真の賢者の唯一の情報元です。  

• 様々なリアルタイム関数の精度はその値または引数が表現された単位から連想される より低いかも知れません。例えば、たいていのUnixシステムでは時計の「目盛」は 秒の50または100倍でしかありませんし、Macでは時間は秒程度の正確さしか ありません。

• 一方では、time()とsleep()の精度はUnixの相当する関数より 高いです。時間は浮動小数で表現されていますし、time()は利用できる 最も正確な時間(使えればUnixのgettimeofday()を使う)を返しますし、 sleep()は0でない端数を持った時間を受け入れます(これを実装するために 利用可能であればUnixのselect()が使われます)。

• gmtime()とlocaltime()によって返される、または mktime()で受け入れられる時間のタプルは9つの整数のタプルです。 つまり、年(例えば1993), 月(1-12), 日(1-31), 時(0-23), 分(0-59), 秒(0-59), 曜日(0-6, 月曜は0), 日数(1-366), 夏時間フラグ(-1, 0 または 1)。
  注：Cの構造体と異なり、月の値は1-12の範囲であり0-11ではありません。 100未満の年の値は暗黙のうちにその年の値に1900を足したものに変換されます。 mktime()に夏時間フラグとして引数-1が渡されると 普通は適切な夏時間状態で満たされて結果が導かれます。

このモジュールは以下の関数とデータアイテムを定義しています。

altzone

ローカルなDST時間帯のオフセットで、定義されていれば０番目の子午線の西側での 秒数で表現されます。ローカルなDST時間帯が０番目の子午線の東側であれば負の数 になります（英国を含む西ヨーロッパのように）。 daylightが０でないときのみ使用するようにして下さい。

asctime (tuple)

gmtime()またはlocaltime()が返すような時間のタプル表現を 'Sun Jun 20 23:21:05 1993'のような形式の２４文字の文字列に変換します。
注：Cの同じ名前の関数と異なり最後の改行はありません。

clock ()

現在のCPU時間を秒を単位とした浮動小数として返します。 精度と実際には「CPU時間」 そのものの意味付けは 同じ名前のCの関数のそれに依存します。しかしいずれにしてもこれはパイソンの ベンチマーキングまたはタイミングアルゴリズム用に使われる関数となります。

ctime (secs)

エポックからの秒数で表現された時間をローカル時間を表す文字列に変換します。 ctime(secs)はasctime(localtime(secs))と 同じです。

daylight

DST時間帯が定義されていれば０ではありません。

gmtime (secs)

エポックからの秒数で表現された時間を夏時間フラグが常に０であるUTCの 時間タプルに変換します。秒の端数は無視されます。

localtime (secs)

gmtime()に似ていますがローカル時間に変換します。 DSTが与えられた時間に適用されていれば夏時間フラグは1に設定されます。

mktime (tuple)

これはlocaltimeの逆関数です。引き数はUTCではなくローカル時間を 表現する完全な９つの要素を持つタプル（夏時間フラグが必要です。不明であれば夏時間 フラグに-1を渡してください）です。 これはtime()との互換性のために浮動小数を返します。 入力値が有効な時間表現ではない場合には、OverflowError例外が 発生します。

sleep (secs)

与えられた秒数の間実行を中断します。より正確なスリープ時間を指示するために 引き数に浮動小数を渡すことも出来ます。

strftime (format, tuple)

gmtime()またはlocaltime()が返すような時間のタプル表現 をフォーマット引き数で指定されたような文字列に変換します。

以下の命令（オプションのフィールド幅と精度指定を省略しています） がその意味で示された文字で置き換えられます。

命令	意味
%a	短縮された曜日の名称（そのロケールでの）
%A	完全な曜日の名称（そのロケールでの）
%b	短縮された月の名称（そのロケールでの）
%B	完全な月の名称（そのロケールでの）
%c	適切な日付けと時間表現（そのロケールでの）
%d	１０進数での月内の日数 [01,31]
%H	１０進数での時間（２４時間制） [00,23].
%I	１０進数での時間（１２時間制） [01,12].
%j	１０進数での年内の日数 [001,366].
%m	１０進数での月 [01,12]
%M	１０進数での分 [00,59]
%p	AMまたはPMと同等のもの（そのロケールでの）
%S	１０進数での秒 [00,61]
%U	１０進数での年内の週番号（週の開始は日曜として） [00,53] 新年の最初の日曜までのすべての日は０番目の週と考えられます。
%w	１０進数での曜日 [0(日曜),6].
%W	１０進数での年内の週番号（週の開始は月曜として） [00,53] 新年の最初の月曜までのすべての日は０番目の週と考えられます。
%x	適切な日付け表現（そのロケールでの）
%X	適切な時間表現（そのロケールでの）
%y	１０進数での世紀を除いた年 [00,99]
%Y	１０進数での世紀を入れた年
%Z	時間帯の名前（または時間帯がなければ文字は入りません）
%%	%

追加の命令があるプラットフォームではサポートされているかもしれませんが、 ここにあげられたもののみがANSI Cで標準化された意味を持っています。

いくつかのプラットフォームではオプションのフィールド幅と精度指定は 命令の最初の%のすぐ後に指定することができますが、これは 移植性は良くありません。フィールド幅は通常２ですが%jについては ３です。

time ()

エポックからの秒数で表現された浮動小数として時間をUTCで返します。 時間は常に浮動小数として返されますが、すべてのシステムで１秒より良い精度 で時間を提供しているわけではないことに注意して下さい。

timezone

０番目の子午線の西側での秒数で表現されたローカル（DSTでない）時間帯の オフセットです。（つまり西ヨーロッパのほとんどでは負で、米国では正で、 英国では０です。）

tzname

２つの文字列からなるタプルです。１番目はローカル（DSTでない）時間帯の 名前で、２番目はローカルDST時間帯の名前です。 DST時間帯が定義されていなければ２番目の文字列を使うべきではありません。