返回程序占用的 CPU 时间（秒，小数）。用于测某段代码的执行耗时。

无参数

CPU 秒数（number）

local t = os.clock()
-- ...干重活...
print('耗时', os.clock() - t, '秒')

格式化日期时间。format 含 %Y年 %m月 %d日 %H时 %M分 %S秒；"*t" 返回年月日时分秒的表；无参返回默认格式串。做每日限次/整点活动必备。

格式化字符串 或 时间表

print(os.date('%Y-%m-%d %H:%M'))   --> 2026-09-20 10:30
local d = os.date('*t')
print(d.year, d.month, d.day, d.hour)

-- 每日限次: 比较日期串
local today = os.date('%Y%m%d')

返回两个时间戳的差 t2 - t1（秒，浮点）。os.time 值相减通常已够用。

秒差

print(os.difftime(os.time{hour=12}, os.time{hour=8}))   --> 14400

调用操作系统执行外部命令。安全风险极大，游戏服务器环境通常禁用。

成功 true；失败 nil；省略命令检测 shell

-- print(os.execute('echo hi'))

终止宿主程序（对游戏来说就是直接关引擎/客户端！）。开发脚本绝对不要调用。

无（不会返回）

-- os.exit()   -- 严禁在游戏脚本中调用!

读取系统环境变量的值，不存在返回 nil。

变量值 或 nil

print(os.getenv('PATH'))

删除文件（或空目录）。失败返回 nil+错误。

成功 true；失败 nil, err

os.remove('临时.txt')

重命名文件/目录（也可当移动用）。失败返回 nil+错误。

成功 true；失败 nil, err

os.rename('old.lua', 'new.lua')

设置本地化区域（影响字符分类/数字格式等）。游戏脚本一般不动它。

当前区域名 或 nil

print(os.setlocale())   --> 查询当前区域

取时间戳：无参=当前时间戳（秒）；传表 {year,month,day[,hour,min,sec]} 得指定时刻的时间戳。做冷却、每日重置、限时活动的基石。

时间戳（秒）

print(os.time())   --> 1789951200

-- 指定时间的时间戳
local t = os.time{year=2026, month=10, day=1, hour=0}
print(os.time() < t)   -- 国庆到了吗

-- 明天零点时间戳(每日刷新)
local next0 = os.time{year=os.date('*t').year, month=os.date('*t').month,
                      day=os.date('*t').day + 1, hour=0}

生成一个临时文件名字符串（不创建文件）。配合 io.open 使用；一般用 io.tmpfile 更省心。

无参数

临时文件名

local name = os.tmpname()
print(name)