全部產品

CDN：時間相關

更新時間：Sep 15, 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`