日期时间函数

事实上，在 Nginx/Openresty 中，会经常使用到获取时间操作，通常一次请求最少有几十次获取时间操作，当单核心 RPS/QPS 达到 10K 以上时，获取时间操作往往会达到 200K+量级的调用，是一个非常高频的调用。所以 Nginx 会将时间和日期进行缓存，并非每次调用或每次请求获取时间和日期。

推荐 使用 ngx_lua 模块提供的带缓存的时间接口，如 ngx.today, ngx.time, ngx.utctime, ngx.localtime, , ngx.http_time，以及 ngx.cookie_time 等。

ngx.today()

语法：str = ngx.today()

该接口从 Nginx 缓存的时间中获取时间，返回当前的时间和日期，其格式为yyyy-mm-dd（与 Lua 的日期库不同，不涉及系统调用）。

ngx.time()

语法：secs = ngx.time()

该接口从 Nginx 缓存的时间中获取时间，返回当前时间戳的历时秒数（与 Lua 的日期库不同，不涉及系统调用）。

ngx.now()

语法：secs = ngx.now()

该接口从 Nginx 缓存的时间中获取时间，以秒为单位（包括小数部分的毫秒）返回从当前时间戳开始的浮点数（与 Lua 的日期库不同，不涉及系统调用）。

ngx.localtime()

语法：

ngx.utctime()

语法：str = ngx.utctime()

返回 Nginx 缓存时间的当前 UTC 时间戳（格式为 yyyy-mm-dd hh:MM:ss）（与 Lua 的日期库不同，不涉及系统调用）。

ngx.update_time()

语法：ngx.update_time()

强制更新 Nginx 当前时间缓存。这个调用涉及到一个系统调用，因此有一些开销，所以不要滥用。

获取时间示例代码

示例代码：

（不推荐） Lua 自带的日期和时间函数

在 OpenResty 的世界里，不推荐 使用这里的标准时间函数，因为这些函数通常会引发不止一个昂贵的系统调用，同时无法为 LuaJIT JIT 编译，对性能造成较大影响。

所以下面的部分函数，简单了解一下即可。

os.time ([table])

• 如果不使用参数 table 调用 time 函数，它会返回 当前 的时间和日期（它表示从某一时刻到现在的秒数）。

• 如果用 table 参数，它会返回一个数字，表示该 table 中所描述的日期和时间（它表示从某一时刻到 table 中描述日期和时间的秒数）。

table 的字段如下：

os.difftime (t2, t1)

返回 t1 到 t2 的时间差，单位为秒。

os.date ([format [, time]])

把一个表示日期和时间的数值，转换成更高级的表现形式。

• 第二个参数 time 就是日期和时间的数字表示，缺省时默认为当前的时间。

使用格式字符 “*t”，创建一个时间 table。

该表中除了使用到了 函数参数 table 的字段外，这还提供了星期（wday，星期天为 1）和一年中的第几天（yday，一月一日为 1）。 除了使用 “*t” 格式字符串外，如果使用带标记（见下表）的特殊字符串，os.date 函数会将相应的标记位以时间信息进行填充，得到一个包含时间的字符串。 表如下：