OS時間

OS時間

標準Lua os時間関数。タイムスタンプ、日付フォーマット、時間計算のための実際のウォールクロック時間を提供。

ロード

グローバルosテーブル。requireは不要。

os.time()
os.date()
os.clock()
os.difftime()

タイムスタンプの取得

Unixタイムスタンプ（1970年1月1日UTC以降の秒数）を取得:

-- 現在のタイムスタンプ
local now = os.time()  -- 1718462445

-- 特定の日時
local t = os.time({
    year = 2024,
    month = 12,
    day = 25,
    hour = 10,
    min = 30,
    sec = 0
})

シグネチャ: os.time([spec]) -> number

パラメータ:

フィールド	型	デフォルト	説明
year	number	現在の年	4桁の年（例: 2024）
month	number	現在の月	月 1-12
day	number	現在の日	日 1-31
hour	number	0	時 0-23
min	number	0	分 0-59
sec	number	0	秒 0-59

引数なしで呼び出すと、現在のUnixタイムスタンプを返す。

テーブルで呼び出すと、不足しているフィールドは上記のデフォルト値を使用。year、month、dayフィールドは指定されない場合、現在の日付がデフォルト。

-- 日付のみ（時間はデフォルトで深夜0時）
os.time({year = 2024, month = 6, day = 15})

-- 部分的（現在の年/月を補完）
os.time({day = 1})  -- 現在の月の1日

日付のフォーマット

タイムスタンプを文字列にフォーマットするか、日付テーブルを返す:

local now = os.time()

— デフォルトフォーマット os.date() — “Sat Jun 15 14:30:45 2024”

— カスタムフォーマット os.date(“%Y-%m-%d”, now) — “2024-06-15” os.date(“%H:%M:%S”, now) — “14:30:45” os.date(“%Y-%m-%dT%H:%M:%S”, now) — “2024-06-15T14:30:45”

— UTC時間（フォーマットの前に!を付ける） os.date(”!%Y-%m-%d %H:%M:%S”, now) — ローカルの代わりにUTC

— 日付テーブル local t = os.date(“*t”, now)

シグネチャ: os.date([format], [timestamp]) -> string | table

パラメータ	型	デフォルト	説明
format	string	"%c"	フォーマット文字列、テーブルには"*t"
timestamp	number	現在時刻	フォーマットするUnixタイムスタンプ

フォーマット指定子

コード	出力	例
%Y	4桁の年	2024
%y	2桁の年	24
%m	月 (01-12)	06
%d	日 (01-31)	15
%H	24時間制の時 (00-23)	14
%I	12時間制の時 (01-12)	02
%M	分 (00-59)	30
%S	秒 (00-59)	45
%p	AM/PM	PM
%A	曜日名	Saturday
%a	曜日略称	Sat
%B	月名	June
%b	月略称	Jun
%w	曜日 (0-6, 日曜=0)	6
%j	年間日 (001-366)	167
%U	週番号 (00-53)	24
%z	タイムゾーンオフセット	-0700
%Z	タイムゾーン名	PDT
%c	完全な日時	Sat Jun 15 14:30:45 2024
%x	日付のみ	06/15/24
%X	時刻のみ	14:30:45
%%	リテラル%	%

日付テーブル

フォーマットが"*t"の場合、テーブルを返す:

local t = os.date("*t")

フィールド	型	説明	例
year	number	4桁の年	2024
month	number	月 (1-12)	6
day	number	日 (1-31)	15
hour	number	時 (0-23)	14
min	number	分 (0-59)	30
sec	number	秒 (0-59)	45
wday	number	曜日 (1-7, 日曜=1)	7
yday	number	年間日 (1-366)	167
isdst	boolean	夏時間	false

UTC日付テーブルには"!*t"を使用。

経過時間の測定

Luaランタイム開始からの経過秒数を取得:

local start = os.clock()

-- 作業を実行
for i = 1, 1000000 do end

local elapsed = os.clock() - start
print(string.format("Took %.3f seconds", elapsed))

シグネチャ: os.clock() -> number

時間差

2つのタイムスタンプ間の差を秒で取得:

local t1 = os.time({year = 2024, month = 1, day = 1})
local t2 = os.time({year = 2024, month = 12, day = 31})

local diff = os.difftime(t2, t1)  -- t2 - t1
local days = diff / 86400
print(days)  -- 365

シグネチャ: os.difftime(t2, t1) -> number

パラメータ	型	説明
t2	number	後のタイムスタンプ
t1	number	前のタイムスタンプ

秒単位でt2 - t1を返す。t1 > t2の場合は負になる。

プラットフォーム定数

ランタイムを識別する定数:

os.platform  -- "wippy"