Lua+os.date：格式化日期的模式本质

【语法算法】

os.date 的格式化模式就这一行：

os.date("%Y-%m-%d %H:%M:%S")

占位符 %Y%m%d%H%M%S 分别对应年月日时分秒——os.date 的格式化本质就是把时间戳翻译成人类可读的日期字符串。今天拆开。

一、占位符、组合、时区三段

os.date 的三段。占位符：%Y 四位年、%m 两位月、%d 两位日——%H 两位时、%M 两位分、%S 两位秒——占位符的自由组合覆盖了所有日期格式的需求。组合：os.date("%Y年%m月%d日") 输出中文格式——占位符之间可以插入任意文字——中英文混合格式一行搞定。时区：os.date 默认返回本地时间——os.date("!%Y-%m-%d") 加感叹号切换为 UTC 时间——感叹号是 UTC 的开关。三段连起来：os.date 玩的是"时间戳到字符串的翻译"——时间戳是机器的语言，格式化字符串是人的语言——os.date 就是翻译官。

graph TD
    A["os.date(format)"] --> B["%Y → 2024"]
    A --> C["%m → 06"]
    A --> D["%d → 15"]
    A --> E["%H:%M:%S → 14:30:00"]
    B --> F["组合格式"]
    C --> F
    D --> F
    E --> F

二、格式化的正确写法

-- 获取当前日期
print(os.date("%Y-%m-%d"))  -- 2024-06-15

-- 获取当前时间
print(os.date("%H:%M:%S"))  -- 14:30:00

-- 中文日期
print(os.date("%Y年%m月%d日"))

-- 带感叹号: UTC时间
print(os.date("!%Y-%m-%d"))

-- 从时间戳格式化
print(os.date("%Y-%m-%d", 1718400000))

-- 获取日期表
local t = os.date("*t")
print(t.year, t.month, t.day, t.hour, t.min, t.sec)

os.date("*t") 返回日期表——日期表包含 year/month/day/hour/min/sec 字段——比解析格式化字符串更直接。

三、跨平台的差异与时区的坑

%Y 和 %y 的区别：%Y 是四位年份（2024），%y 是两位年份（24）——两者混用会导致年份排序出错——日期字符串的排序依赖格式的一致性。时区的坑也值得记：服务器时区和玩家时区可能不同——os.date 默认用服务器时区——如果需要按玩家时区显示，必须手动加时区偏移——跨时区的日期处理是游戏服务端最常见的坑之一。最后一条纪律：os.date 的格式化字符串不要硬编码在多处——定义一个常量表统一管理格式——格式散落在多个文件里，改一个格式要改十个地方。