タイム-タイム-アクセスと変換¶

関数¶

time.asctime()¶

タプルまたはstruct_timegmtime()またはiv idによって返される時間を表すタプルまたはstruct_timeを変換します=”F64b4a52f9″>次のフォームの文字列に：'Sun Jun 20 23:21:05 1993'。 たとえば、'Wed Jun 9 04:26:40 1993'です。,

tが指定されていない場合、localtime()によって返される現在の時刻が使用されます。 ロケール情報はasctime()では使用されません。

time.pthread_getcpuclockid(thread_id)¶

指定されたthread_idのスレッド固有のCPU時間クロックのclk_idを返します。,

使用threading.get_ident()またはidentthreading.Thread適切な値を取得するためのオブジェクトの属性thread_id。

可用性:Unix(さらなる情報はpthread_getcpuclockid(3)のmanページを参照してください)。

time.clock_getres(clk_id)¶

指定したクロックclk_idの分解能(精度)を返します。, Clk_idの受け入れられる値のリストについては、clock ID定数を参照してください。

可用性：Unix。

time.clock_gettime(clk_id)→float←

指定されたクロックclk_idの時刻を返します。 Clk_idの受け入れられる値のリストについては、clock ID定数を参照してください。

可用性：Unix。

time.clock_gettime_ns(clk_id)→int←

clock_gettime()に似ていますが、時間はナノ秒で返されます。

可用性：Unix。

time.clock_settime(clk_id,time:float)¶

指定したクロックclk_idの時刻を設定します。 現在、CLOCK_REALTIMEはclk_idの唯一の受け入れられる値です。

可用性：Unix。

time.clock_settime_ns(clk_id,time:int)≤

clock_settime()に似ていますが、時間をナノ秒で設定します。

可用性：Unix。

time.ctime()÷

エポックからの秒単位で表される時間を、次の形式の文字列に変換します。'Sun Jun 20 23:21:05 1993'ローカル時間を表します。 たとえば、'Wed Jun 9 04:26:40 1993'です。

time.get_clock_info(name)¶

指定されたクロックの情報を名前空間オブジェクトとして取得します。,調整可能:Trueクロックを自動的に変更できる場合(bya NTPデーモンなど)、またはシステム管理者が手動で変更できる場合、Falseそれ以外の場合

time.gmtime()÷

エポックからの秒単位で表される時間を、dstフラグが常にゼロであるstruct_timeinUTCに変換します。 Secsが指定されていない場合、またはNone、time()によって返される現在の時刻が使用されます。, 秒のFractionsofは無視されます。 struct_timeオブジェクトの説明については、上記を参照してください。 Thisfunctionの逆については、calendar.timegm()を参照してください。

time.localtime()÷

gmtime()と同様ですが、ローカル時間に変換されます。 Secsが指定されていない場合、またはNone、time()によって返される現在の時刻が使用されます。 DSTが指定された時間に適用される場合、dstflagは1に設定されます。,

time.mktime(t)÷

これはlocaltime()の逆関数です。 その引数は、struct_timeまたは完全な9タプル（dstフラグが必要なため、不明な場合は-1dstフラグとして使用）です。 これは、time()との互換性のために浮動小数点数を返します。,入力値を有効な時刻として表すことができない場合は、OverflowErrorまたはValueErrorが発生します（無効な値がPythonまたは基になるCライブラリによってキャッチされるかどうかによって異なります）。時間を生成できる最も早い日付は、プラットフォームに依存します。

time.monotonic()→float←

単調なクロックの値（小数秒単位）を返します。 時計はシステム時計の更新の影響を受けません。,返される値の参照ポイントは未定義であるため、連続した呼び出しの結果間の差分のみが有効です。

time.monotonic_ns()→int←

monotonic()に似ていますが、時間はナノ秒で返します。

time.perf_counter()→float←

パフォーマンスカウンタの値（小数秒単位）を返します。, 短い持続期間を測定する最も高い利用できる決断のaclock。 Itdoesは睡眠の間に経過した時間を含み、システム全体である。 返される値のreferencepointは未定義であるため、連続した呼び出しの結果の差のみが有効です。

time.perf_counter_ns()→int←

perf_counter()に似ていますが、時間はナノ秒で返します。

time.process_time()→float←

現在のプロセスのシステム時間とユーザープー時間の合計（小数秒単位）の値を返します。 その間の経過時間は含まれていません睡眠。 定義上、プロセス全体です。 Thereturned値の参照ポイントは未定義であるため、連続した呼び出しのresultsof間の差のみが有効になります。

time.process_time_ns()→int←

process_time()に似ていますが、時間はナノ秒で返します。,

time.sleep(secs)¶

呼び出し元スレッドの実行を指定された秒数だけ中断します。引数は、より正確なスリープタイムを示す浮動小数点数にすることができます。 キャッチされたシグナルは、thatsignalのキャッチルーチンの実行後にsleep()を終了するため、実際のサスペンション時間は要求された時間より また、停止時間は、システム内の他の活動のスケジューリングのために任意の量によって要求されるよりも長くなる可能性がある。,

time.strftime(format)¶

タプルまたはstruct_timegmtime()またはlocaltime()によって返される時刻を表すタプルを変換します。フォーマット引数。 Tが指定されていない場合、localtime()によって返される現在の時刻が使用されます。 formatは文字列でなければなりません。, ValueErrort内のいずれかのフィールドが許容範囲外である場合にイスラエル化されます。

0は、timeタプル内の任意の位置に対する正当な引数です。

書式文字列には以下のディレクティブを埋め込むことができます。, これらは、オプションのフィールド幅と精度指定なしで表示され、strftime()結果

注

1. strptime()関数と一緒に使用すると、%pディレクティブは、%Iディレクティブは、時間を解析するために使用されます。,

2. 範囲は実際には0から61;value60うるう秒を表す有効なintimestampsであり、value61は歴史的な理由からサポートされています。

3. strptime()関数と共に使用する場合、%Uおよび%Wは、曜日と年が指定されている場合にのみ使用されます。

ここでは、theRFC2822インターネット電子メール標準で指定されたものと互換性のある日付の形式の例を示します。, 1

>>> from time import gmtime, strftime>>> strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())'Thu, 28 Jun 2001 14:17:15 +0000'

特定のプラットフォームでは追加のディレクティブがサポートされているかもしれませんが、ここに記載されているディレクティブのみがANSI Cによって標準化された意味を持っています。strftime(3)のドキュメントを参照してください。

一部のプラットフォームでは、オプションのフィールド幅と精度指定は、ディレクティブの最初の'%'に次の順序で従うことができます。 フィールド幅は通常2ですが、%jここでは3です。,

time.strptime(string)¶

形式に従って時刻を表す文字列を解析します。 戻り値は、struct_timegmtime()またはlocaltime()によって返されるstruct_timeです。

formatパラメータはstrftime()で使用されるディレクティブと同じディレクティブを使用します;デフォルトは"%a %b %d %H:%M:%S %Y"ctime()によって返されるフォーマッティングに一致します。 フォーマットに従って文字列を解析できない場合、または解析後に余分なデータがある場合は、ValueErrorが使用されます。, より正確な値を推測できない場合に欠損データを埋めるために使用されるデフォルト値は、(1900, 1, 1, 0, 0, 0, 0, 1, -1)です。Stringとformatの両方が文字列である必要があります。

たとえば、

%Zディレクティブのサポートは、tznameに含まれる値とdaylightがtrueかどうかに基づいています。 このため、プラットフォーム固有であり、常に既知であるUTCとGMTを認識するための例外です（そして、非夏時間タイムゾーンであると考えられています）。

ドキュメントで指定されたディレクティブのみがサポートされます。, strftime()はプラットフォームごとに実装されているため、リストされているものよりも多くの方向を提供することがあります。 しかし、strptime()はどのプラットフォームからも独立しているため、サポートされていないすべてのディレクティブをサポートしているわけではありません。

クラスtime.struct_time√

gmtime()、localtime()、およびstrptime()によって返される時間値シーケンスの型。 これはnamedtupleインターフェイスを持つオブジェクトです。, 次の値が存在します。

c構造体とは異なり、月の値は範囲であり、範囲ではないことに注意してください。

mktime()の呼び出しでは、tm_isdstは、daylightsavings timeが有効な場合は1に設定され、有効でない場合は0に設定されます。 値-1は、これが既知ではないことを示し、通常は正しい状態が入力されます。

間違った長さのタプルがstruct_timeを期待する関数に渡された場合、または間違った型の要素を持つ場合、TypeErrorが発生します。,

time.time()→float←

エポックからの秒数を浮動小数点数として返します。 エポックの特定の日付とリープ秒の処理はプラットフォームに依存します。WindowsおよびほとんどのUnixシステムでは、エポックはJanuary1、1970,00:00:00(UTC)であり、うるう秒はエポックからの秒数にはカウントされません。 これは一般的にasUnixと呼ばれていますtime.To 特定のプラットフォーム上のエポックが何であるかを調べるには、gmtime(0)を見てください。,

時刻は常に浮動小数点数として返されますが、すべてのシステムが1秒よりも優れた精度で時間を提供するわけではありません。この関数は通常、減少しない値を返しますが、システムクロックが二つの呼び出しの間に設定されている場合、以前の呼び出しよりもalower値を返すこと

time()によって返される数値は、UTCでgmtime()関数に渡すことによって、またはlocaltime()関数に渡すことによって、ローカル時間で、より一般的な時間形式（つまり、年、月、日、時間など）に変換することができます。, どちらの場合も、struct_timeオブジェクトが返され、そこからカレンダー日付のcomponentsofが属性としてアクセスできます。

time.thread_time()→float←

現在のスレッドのシステム時間とユーザープー時間の合計（小数秒単位）の値を返します。 その間の経過時間は含まれていません睡眠。 定義上、スレッド固有です。 Thereturned値の参照ポイントは未定義であるため、同じスレッド内の連続した呼び出しのresultsofの差のみが有効です。,

可用性：windows、Linux、サポートするUnixシステムCLOCK_THREAD_CPUTIME_ID。

time.thread_time_ns()→int←

thread_time()に似ていますが、時間はナノ秒で返します。

time.time_ns()→int←

time()に似ていますが、エポックからナノセコンドの整数として時間を返します。

time.tzset()¶

ライブラリルーチンで使用される時間変換ルールをリセットします。 EnvironmentvariableTZこれがどのように行われるかを指定します。, また、変数tzname（TZ環境変数から）、timezone（UTCより西のDSTseconds）、altzone（UTCより西のDST秒）、daylight（UTCより西のDST秒）を設定します。このタイムゾーンには夏時間のルールはなく、夏時間が適用されるときに時間、過去、現在、または未来がある場合はtononzero）。

可用性：Unix。,

TZ環境変数の標準形式は（明確にするためにwhitespaceadded）です：

std offset , end]]]

コンポーネントは次のとおりです。

stdおよびdst

タイムゾーンの略語を与える三つ以上の英数字。 これらは時間にbepropagated。tzname

offset

オフセットの形式は± hh]です。 これは、utcに到着するローカル時間を追加した値を示します。, 前に’-‘が付いている場合、タイムゾーンは本初子午線の東にあり、それ以外の場合は西にあります。 オフセットが続かない場合、夏時間は標準時より一時間先であると見なされます。

start, end

DSTに切り替えるタイミングを示します。 開始日と終了日の形式は次のいずれかです。

Jn

ユリウス日n(1<=n<=365)。 うるう日はカウントされないので、すべての年February28は59日目であり、March1は60日目です。,

n

ゼロベースのユリウス日（0<=n<=365）。 うるう日がカウントされ、February29を参照することができます。

Mm.n.d

timeはoffsetと同じ形式ですが、先頭の記号（’-‘または’+’）は許可されていません。 時刻が指定されていない場合のデフォルトは02:00:00です。多くのUnixシステム(*BSD、Linux、Solaris、Darwinを含む)では、タイムゾーンルールを指定するために、システムのzoneinfo(tzfile(5))データベースを使用する方が便利です。, これを行うには、TZenvironmentvariableを、通常/usr/share/zoneinfoにあるシステム’zoneinfo’タイムゾーンデータベースのルートに対する相対パスに必要なタイムゾーンデータファイルのパスに設定します。 たとえば、'US/Eastern'、'Australia/Melbourne'、'Egypt'または'Europe/Amsterdam'です。

>>> os.environ = 'US/Eastern'>>> time.tzset()>>> time.tzname('EST', 'EDT')>>> os.environ = 'Egypt'>>> time.tzset()>>> time.tzname('EET', 'EEST')