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

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