全部產品
Search

搜尋本產品

    ApsaraVideo VOD：時間相關

    文件中心

    ApsaraVideo VOD：時間相關

    更新時間：Feb 27, 2025

    本文為您介紹時間相關函數的文法、說明、參數、傳回值和樣本。

    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