时间相关

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

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