• 日期时间函数
    • os.time ([table])
    • os.difftime (t2, t1)
    • os.date ([format [, time]])

    日期时间函数

    在 Lua 中,函数 time、date 和 difftime 提供了所有的日期和时间功能。

    在 OpenResty 的世界里,不推荐使用这里的标准时间函数,因为这些函数通常会引发不止一个昂贵的系统调用,同时无法为 LuaJIT JIT 编译,对性能造成较大影响。推荐使用 ngx_lua 模块提供的带缓存的时间接口,如 ngx.today, ngx.time, ngx.utctime,
    ngx.localtime, ngx.now, ngx.http_time,以及 ngx.cookie_time 等。

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

    os.time ([table])

    如果不使用参数 table 调用 time 函数,它会返回当前的时间和日期(它表示从某一时刻到现在的秒数)。如果用 table 参数,它会返回一个数字,表示该 table 中 所描述的日期和时间(它表示从某一时刻到 table 中描述日期和时间的秒数)。table 的字段如下:

    字段名称 取值范围
    year 四位数字
    month 1—12
    day 1—31
    hour 0—23
    min 0—59
    sec 0—61
    isdst boolean(true表示夏令时)

    对于 time 函数,如果参数为 table,那么 table 中必须含有 year、month、day 字段。其他字缺省时段默认为中午(12:00:00)。

    示例代码:(地点为北京)

    1. print(os.time()) -->output 1438243393
    2. a = { year = 1970, month = 1, day = 1, hour = 8, min = 1 }
    3. print(os.time(a)) -->output 60

    os.difftime (t2, t1)

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

    示例代码:

    1. local day1 = { year = 2015, month = 7, day = 30 }
    2. local t1 = os.time(day1)
    3. local day2 = { year = 2015, month = 7, day = 31 }
    4. local t2 = os.time(day2)
    5. print(os.difftime(t2, t1)) -->output 86400

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

    把一个表示日期和时间的数值,转换成更高级的表现形式。其第一个参数 format 是一个格式化字符串,描述了要返回的时间形式。第二个参数 time 就是日期和时间的数字表示,缺省时默认为当前的时间。使用格式字符 “*t”,创建一个时间表。

    示例代码:

    1. local tab1 = os.date("*t") --返回一个描述当前日期和时间的表
    2. local ans1 = "{"
    3. for k, v in pairs(tab1) do --把tab1转换成一个字符串
    4. ans1 = string.format("%s %s = %s,", ans1, k, tostring(v))
    5. end
    6. ans1 = ans1 .. "}"
    7. print("tab1 = ", ans1)
    8. local tab2 = os.date("*t", 360) --返回一个描述日期和时间数为360秒的表
    9. local ans2 = "{"
    10. for k, v in pairs(tab2) do --把tab2转换成一个字符串
    11. ans2 = string.format("%s %s = %s,", ans2, k, tostring(v))
    12. end
    13. ans2 = ans2 .. "}"
    14. print("tab2 = ", ans2)
    15. -->output
    16. tab1 = { hour = 17, min = 28, wday = 5, day = 30, month = 7, year = 2015, sec = 10, yday = 211, isdst = false,}
    17. tab2 = { hour = 8, min = 6, wday = 5, day = 1, month = 1, year = 1970, sec = 0, yday = 1, isdst = false,}

    该表中除了使用到了 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)
    %% 字符’%’

    示例代码:

    1. print(os.date("today is %A, in %B"))
    2. print(os.date("now is %x %X"))
    3. -->output
    4. today is Thursday, in July
    5. now is 07/30/15 17:39:22