本文为您介绍时间相关函数的语法、说明、参数、返回值和示例。

today

函数详细信息，请参见下表：
项目描述
语法today()。
说明返回当前时间（本地时间）字符串，格式：yyyy-mm-dd。
参数无。
返回值返回当前时间字符串，格式：yyyy-mm-dd。
示例
say(concat('today:', today()))
输出：
today:2019-05-23

time

函数详细信息，请参见下表：
项目描述
语法time()。
说明返回当前的UNIX时间戳（不包含毫秒的小数部分），单位：秒。
说明 UNIX时间戳不区分时区，表示的是从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数。
参数无。
返回值返回当前的UNIX时间戳。
示例
say(concat('time:', time()))
输出：
time:1559109666

now

函数详细信息，请参见下表：
项目描述
语法now()。
说明返回当前的UNIX时间戳（数值类型，包含毫秒的小数部分），单位：秒。
说明 UNIX时间戳不区分时区，表示的是从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数。
参数无。
返回值返回当前的UNIX时间戳（数值类型，包含毫秒的小数部分），单位：秒。
示例
say(concat('now:', now()))
输出：
now:1559109666.644

localtime

函数详细信息，请参见下表：
项目描述
语法localtime()。
说明返回当前时间（本地时间）字符串，格式：yyyy-mm-dd hh:mm:ss。
参数无。
返回值返回当前时间字符串，格式：yyyy-mm-dd hh:mm:ss。
示例
say(concat('localtime:', localtime()))
输出：
localtime:2019-05-29 14:02:41

utctime

函数详细信息，请参见下表：
项目描述
语法utctime()。
说明返回当前时间字符串（UTC时间），格式：yyyy-mm-dd hh:mm:ss。
参数无。
返回值返回当前时间字符串，格式：yyyy-mm-dd hh:mm:ss。
示例
say(concat('utctime:', utctime()))
输出：
utctime:2019-05-29 06:02:41

cookie_time

函数详细信息，请参见下表：
项目描述
语法cookie_time(sec)。
说明生成cookie格式的GMT时间字符串。
参数sec：UNIX时间戳。例如：调用time()获取。
返回值基于sec表示的UNIX时间戳，返回cookie格式的时间字符串。
示例
say(concat('cookie_time:', cookie_time(time())))
输出：
cookie_time:Wed, 29-May-19 06:02:41 GMT

http_time

函数详细信息，请参见下表：
项目描述
语法http_time(sec)。
说明生成HTTP header格式的时间字符串。例如：Last-Modified。
重要 该函数只能生成GMT标准的时间。
参数sec：UNIX时间戳。例如：调用time()获取。
返回值基于sec表示的UNIX时间戳，返回HTTP header格式的时间字符串，用于HTTP头的时间。
示例
say(concat('http_time:', http_time(time())))
输出
http_time:Wed, 29 May 2019 06:02:41 GMT

parse_http_time

函数详细信息，请参见下表：
项目描述
语法parse_http_time(str)。
说明解析HTTP header格式的时间字符串，并返回对应的UNIX时间戳。
重要 该函数不识别时区，因此需要把本地时间先转换为GMT标准的时间以后再传递给该函数。
参数str：待转换的HTTP header格式的时间字符串。格式：Wed, 29 May 2019 06:02:41 GMT。调用http_time()获取。
返回值成功返回UNIX时间戳，失败返回false。
示例
say(concat('parse_http_time:', parse_http_time(http_time(time()))))
输出
parse_http_time:1559109761

unixtime

函数详细信息，请参见下表：
项目描述
语法unixtime(year, month, day, hour, min, sec)。
说明根据本地时间的年、月、日、时、分、秒，生成UNIX时间戳并返回。
说明 UNIX时间戳不区分时区，表示的是从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数。
参数
  • year：指定年。
  • month：指定月。
  • day：指定日。
  • hour：指定小时。
  • min：指定分钟。
  • sec：指定秒。
返回值返回转换后的UNIX时间戳。
示例
  • 示例一：
    t = unixtime(1970, 1, 1, 8, 0, 0)
say(concat('unixtime()=', t))

    输出

    unixtime()=0
  • 示例二：
    t = unixtime(2021,12,23,0,0,0)
say(concat('unixtime()=', t))

    输出

    unixtime()=1640188800