このライブラリは、現在 UTC 形式のシステム時間に関する情報を提供する目的で使用されています。標準の Lua ライブラリから重度にサンドボックスされ、システム変更オペレーションを実行することはできません。
概要
関数
clock
サブマイクロ秒単位の精度のある任意のベースとの間の時間を秒単位で返します。この関数は、同じコンピューターで 2つのイベントが発生する間の比較に便利で、ベンチマークの最高のオプションです。
機能のように os.time() または DateTime.now() のような、システムクロックに調整を加えると、時間がユーザーによってジャンプしたり、NTPによって後ろ向きにジャンプしたりすることはありません。
-- 最初の時間を記録:local startTime = os.clock()-- 以下のパフォーマンスを測定したいことをしてください:local a, b = 0, 1for _ = 1, 5000000 doa, b = b, aend-- これが取った時間を測定する:local deltaTime = os.clock() - startTimeprint("Elapsed time: " .. deltaTime)--> Elapsed time: 0.044425600033719 (actual number may vary)
戻り値
date
指定された時間に基づく formatString をフォーマットするか、提供されていない場合は Library.os.time() によって返された値を基にしています。
新しいワークではこの関数を避ける必要があります。代わりに、ローカライズされた形式をサポートする DateTime API を使用してください。
次の特定子 (C 関数 strstrtime に基づく) がサポートされています:
<tbody><tr><td>%a</td><td>一週間の名前 \*</td><td>月</td></tr><tr><td>%A</td><td>毎日の名前 \*</td><td>月曜日</td></tr><tr><td>%b</td><td>簡略月名\*</td><td>2月</td></tr><tr><td>%B</td><td>フルネーム \*</td><td>2月</td></tr><tr><td>%c</td><td>日付と時刻\*</td><td>2月12日(月)14:14:35 2024</td></tr><tr><td>%d</td><td>月の日</td><td>12</td></tr><tr><td>%H</td><td>24時間の時計を使用して 1 時間</td><td>14</td></tr><tr><td>%I</td><td>12時間の時計を使用して 1 時間</td><td>02</td></tr><tr><td>%j</td><td>年の日</td><td>043</td></tr><tr><td>%m</td><td>月</td><td>02</td></tr><tr><td>%M</td><td>分</td><td>14</td></tr><tr><td>%p</td><td>「AM」または「PM」</td><td>午後</td></tr><tr><td>%S</td><td>2番目</td><td>35</td></tr><tr><td>%U</td><td>週の番号 (最初の週の最初の日曜日)</td><td>06</td></tr><tr><td>%w</td><td>平日</td><td>1</td></tr><tr><td>%W</td><td>週の番号 (最初の月曜日が週の 1 日目として扱われます)</td><td>07</td></tr><tr><td>%x</td><td>日付 \*</td><td>2012/12/24</td></tr><tr><td>%X</td><td>時間\*</td><td>14:14:35</td></tr><tr><td>%y</td><td>2 桁の年</td><td>24</td></tr><tr><td>%Y</td><td>1年間</td><td>2024</td></tr><tr><td>%z</td><td>時間帯 (1分 = 1、1時間 = 100) から UTC のオフセット</td><td>0800</td></tr><tr><td>%Z</td><td>時間帯名または略称 \*</td><td>PST</td></tr><tr><td>%</td><td>% 文字</td><td>%</td></tr></tbody>
仕様 | 意味 | Example † |
---|
この値は、現在のローカルによって変更される可能性があります。
※提供されている例は、2024年2月12日 (月曜日) の午後 2:14:35 (14:14:35) に実行されています。PST のローカル時間 (PST) では、ローカル "en-us" を使用しています。
指定した formatString が正確に "*t" (ローカル時間) または "!*t" (UTC 時間) である場合、この関数は、上記のスペックライターの上にあるディクションに含まれる次のコンポーネントを含むダイクトリを返します。これらのコンポーネントは通常、上記の指定に従って、スペックライターの上にありま
<tbody><tr><td>年</td><td>int</td><td>現在の時代の現在の年を記述する整数 (例: 2017)</td></tr><tr><td>月</td><td>int</td><td>1 から 12 の間の整数 (1 月から開始) は、現在の月を記述します。</td></tr><tr><td>wday</td><td>int</td><td>1 から 7 の間の整数 (日曜日を含む) が現在の週の日を記述します。</td></tr><tr><td>yday</td><td>int</td><td>1 から 366 の間の整数で、1年のある日数を表現します。レープ年の場合は、366 日があります。</td></tr><tr><td>日</td><td>int</td><td>1 から 31 の間の整数で、現在の月の日を記述します。</td></tr><tr><td>時間</td><td>int</td><td>1 から 24 の間の整数で、現在の時間を記述します。</td></tr><tr><td>分</td><td>int</td><td>0 から 59 の間の整数で、現在の時刻を表現します。</td></tr><tr><td>秒</td><td>int</td><td>0 から 60 の間の整数で、現在の秒を記述します。(60 は、レープ秒を指示する機能が記述されていますが、実際はそうではありません)。</td></tr><tr><td>isdst</td><td>ブール</td><td>現在、日光貯蔵時間が有効であるかどうかを表示するブーレット。</td></tr></tbody>
フィールド | タイプ | 説明 |
---|
戻り値
time
現在の UTC 時刻 (1 月 1 日 1970、00:00:00) に準拠した Unix エポック (1 月 1 日 1970、00:00:00) からの秒数を返します。os.date() によって同様の形式でテーブルが提供されている場合、その時点の代わりに秒数を返します。
注意、返された時間はデバイスのローカルクロックを使用します。大多数のオペレーションシステムは、オンライン時間サーバーと自動的にローカル時間を同期しますので、これは数百ミリ秒内にある必要があります。ただし、ユーザーはシンクロビーハブで時間を設定したり、クライアントとサーバー間の時間を設定したり
新しいワークではこの関数を避ける必要があります。代わりに、ローカライズされた形式をサポートする DateTime API を使用してください。
パフォーマンスのテストなどで、2つのポイント間の時間を正確に測定する必要がある場合は、os.clock() を使用します。
パラメータ
Library.os.date() によって返された特定の時間を記述したダイクションテーブル。デフォルトでは、現在の UTC 時間を使用します。