全部产品

CDN：时间相关

更新时间：Sep 14, 2024

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

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`