日期时间函数
在 OpenResty 的世界里,不推荐使用这里的标准时间函数,因为这些函数通常会引发不止一个昂贵的系统调用,同时无法为 LuaJIT JIT 编译,对性能造成较大影响。推荐使用 ngx_lua 模块提供的带缓存的时间接口,如 , ngx.time
, ,ngx.localtime
, , ngx.http_time
,以及 等。
所以下面的部分函数,简单了解一下即可。
os.time ([table])
如果不使用参数 table 调用 time 函数,它会返回当前的时间和日期(它表示从某一时刻到现在的秒数)。如果用 table 参数,它会返回一个数字,表示该 table 中 所描述的日期和时间(它表示从某一时刻到 table 中描述日期和时间的秒数)。table 的字段如下:
os.difftime (t2, t1)
返回 t1 到 t2 的时间差,单位为秒。
os.date ([format [, time]])
该表中除了使用到了 time 函数参数 table 的字段外,这还提供了星期(wday,星期天为 1)和一年中的第几天(yday,一月一日为 1)。
除了使用 “*t” 格式字符串外,如果使用带标记(见下表)的特殊字符串,os.date 函数会将相应的标记位以时间信息进行填充,得到一个包含时间的字符串。
表如下:
格式字符 | 含义 |
---|---|
%a | 一星期中天数的简写(例如:Wed) |
%A | 一星期中天数的全称(例如:Wednesday) |
%b | 月份的简写(例如:Sep) |
%B | 月份的全称(例如:September) |
%c | 日期和时间(例如:07/30/15 16:57:24) |
%d | 一个月中的第几天[01 ~ 31] |
%H | 24小时制中的小时数[00 ~ 23] |
%I | 12小时制中的小时数[01 ~ 12] |
%j | 一年中的第几天[001 ~ 366] |
%M | 分钟数[00 ~ 59] |
%m | 月份数[01 ~ 12] |
%p | “上午(am)”或“下午(pm)” |
%S | 秒数[00 ~ 59] |
%w | 一星期中的第几天[1 ~ 7 = 星期天 ~ 星期六] |
%x | 日期(例如:07/30/15) |
%X | 时间(例如:16:57:24) |
%y | 两位数的年份[00 ~ 99] |
%Y | 完整的年份(例如:2015) |
%% | 字符’%’ |