Lua 时间日期处理与时区

-- os.time()：返回当前 Unix 时间戳（秒，整数）
print(os.time())              -- 例如 1759801500

-- os.time(table)：把时间表转为时间戳
local ts = os.time({year = 2026, month = 10, day = 7, hour = 12, min = 0, sec = 0})
print(ts)

-- os.date()：把时间戳格式化为字符串（默认本地时间）
print(os.date("%Y-%m-%d %H:%M:%S"))    -- 当前本地时间

-- os.date("*t")：返回时间表
local t = os.date("*t")
print(t.year, t.month, t.day, t.hour, t.min, t.sec, t.wday)

-- 默认按本地时区解释
print(os.date("%Y-%m-%d %H:%M:%S"))       -- 取决于 TZ

-- 前缀 "!" 强制按 UTC
print(os.date("!%Y-%m-%d %H:%M:%S"))      -- 始终是 UTC

-- 存储：永远用 UTC 时间戳（时间戳本身就是 UTC 无关的绝对时间）
local now = os.time()

-- 存储可读的 UTC 字符串
local utc_str = os.date("!%Y-%m-%dT%H:%M:%SZ", now)

-- 展示：转成用户时区（见下文手动偏移法）

local ts = os.time()
print(os.date("%Y-%m-%d", ts))            -- 2026-10-07
print(os.date("%A, %B %d, %Y", ts))       -- Wednesday, October 07, 2026
print(os.date("%Y-%m-%dT%H:%M:%S%z", ts)) -- 2026-10-07T22:25:30+0800
print(os.date("!%Y-%m-%dT%H:%M:%SZ", ts)) -- 2026-10-07T14:25:30Z（UTC）

-- 已知目标时区相对 UTC 的偏移（小时），把时间戳转为该时区的可读时间
local function to_zone(ts, offset_hours)
    return os.date("!%Y-%m-%d %H:%M:%S", ts + offset_hours * 3600)
end

-- 北京时间 UTC+8
print(to_zone(os.time(), 8))              -- 2026-10-07 22:25:30

local function from_zone(str, offset_hours)
    local y, mo, d, h, mi, s =
        str:match("(%d+)-(%d+)-(%d+) (%d+):(%d+):(%d+)")
    local ts = os.time({
        year = tonumber(y), month = tonumber(mo), day = tonumber(d),
        hour = tonumber(h), min = tonumber(mi), sec = tonumber(s),
        isdst = false,
    })
    -- os.time 按本地时区解释，需先纠正到 UTC 再应用目标偏移
    return ts - os.difftime(os.time(), os.time(os.date("!*t"))) - offset_hours * 3600
end

local luatz = require "luatz"
local tz = luatz.get_tz("Asia/Shanghai")
local tt = tz:locate(os.time())           -- 按该时区解析当前时间
print(tt:strftime("%Y-%m-%d %H:%M:%S"))

local t1 = os.time()
-- ... 做些事 ...
local t2 = os.time()
print(os.difftime(t2, t1))     -- 秒差
print(t2 - t1)                 -- 等价写法（5.3+）

local function days_between(ts1, ts2)
    return math.floor((ts2 - ts1) / 86400)
end

local d1 = os.time({year = 2026, month = 1, day = 1, hour = 0})
local d2 = os.time({year = 2026, month = 12, day = 31, hour = 0})
print(days_between(d1, d2))    -- 364

local function same_day(ts1, ts2, offset_hours)
    offset_hours = offset_hours or 0
    local d1 = os.date("!%Y%m%d", ts1 + offset_hours * 3600)
    local d2 = os.date("!%Y%m%d", ts2 + offset_hours * 3600)
    return d1 == d2
end

-- 错误：os.clock 测的是 CPU 时间
local t0 = os.clock()
local f = io.open("big_file"):read("*a")   -- 大量 IO 等待
print(os.clock() - t0)                     -- 远小于真实耗时（IO 等待不算 CPU）

-- 正确：用 os.time（秒级）或高精度时间源（毫秒/微秒级）
local t0 = os.time()
do_work()
print("耗时:", os.time() - t0, "秒")       -- 秒级精度

-- 需要毫秒级时，用 os.clock 之外的来源：
-- 1) Lua 5.4 无内置高精度计时，可用 socket.gettime（LuaSocket）
local socket = require "socket"
local ms0 = socket.gettime()
do_work()
print(string.format("耗时: %.3f ms", (socket.gettime() - ms0) * 1000))

-- 2) OpenResty 环境用 ngx.now()（毫秒）或 ngx.update_time() + ngx.now()
-- local t0 = ngx.now()

-- OpenResty：ngx.now() 基于单调时钟的毫秒时间
-- 通用场景：用 os.clock（CPU 时间，单调）做相对比较，而非绝对时间

-- 每隔 60 秒执行一次任务，且对齐到整分钟
local function run_every(interval, fn)
    while true do
        fn()
        local now = os.time()
        local next_at = now - (now % interval) + interval
        local sleep = next_at - now
        -- 通用环境无 sleep，需用宿主提供的接口（如 socket.sleep / ngx.sleep）
        socket.sleep(sleep)
    end
end

-- 每 5 秒执行一次
local ok, err = ngx.timer.every(5, function(premature)
    if premature then return end      -- 服务正在关闭
    do_scheduled_job()
end)
if not ok then ngx.log(ngx.ERR, "定时器创建失败: ", err) end