このトピックでは、時間関数の構文、機能、パラメーター、および戻り値について説明します。 このトピックでは、これらの関数の例も示します。

今日

この関数の詳細を次の表に示します。
項目 説明
構文 today()
説明 現在の日付 (現地時間) をyyyy-mm-ddの形式で照会します。
Parameters None
戻り値 yyyy-mm-ddの形式で現在の日付を返します。
例 
say(concat('today:', today()))
出力：
今日: 2019-05-23

time

この関数の詳細を次の表に示します。
項目 説明
構文 time()
説明 現在のUNIXタイムスタンプを照会します (ミリ秒の端数部分を除く) 。 (単位：秒)
注 UNIXタイムスタンプはタイムゾーンとは無関係で、1970年1月1日の00:00:00 (UTCまたはGMT) から経過した秒数を示します。
Parameters なし
戻り値 現在のUNIXタイムスタンプを返します。
例 
say(concat('time:', time()))
出力：
time:1559109666

now

この関数の詳細を次の表に示します。
項目 説明
構文 now()
説明 現在のUNIXタイムスタンプを照会します (ミリ秒の端数部分を除く) 。 (単位：秒)
注 UNIXタイムスタンプはタイムゾーンとは無関係で、1970年1月1日の00:00:00 (UTCまたはGMT) から経過した秒数を示します。
Parameters なし
戻り値 現在のUNIXタイムスタンプ (ミリ秒の端数部分を除く) を返します。 (単位：秒)
例 
say(concat('now:', now()))
次の応答が返されます。
今: 1559109666.644

localtime

この関数の詳細を次の表に示します。
項目 説明
構文 localtime()
説明 yyyy-mm-dd hh:mm:ssの形式で現在の日付と時刻 (現地時間) を照会します。
Parameters なし
戻り値 yyyy-mm-dd hh:mm:ssの形式で現在の日付と時刻を返します。
例 
say(concat('localtime:', localtime()))
出力：
localtime:2019-05-29 14:02:41

utctime

この関数の詳細を次の表に示します。
項目 説明
構文 utctime()
説明 yyyy-mm-dd hh:mm:ssの形式で現在のUTC時刻を照会します。
Parameters なし
戻り値 yyyy-mm-dd hh:mm:ssの形式で現在の日付と時刻を照会します。
例 
say(concat('utctime:', utctime()))
出力：
utctime:2019-05-29 06:02:41

cookie_time

この関数の詳細を次の表に示します。
項目 説明
構文 cookie_time (秒)
説明 cookie形式でGMT時間文字列を生成します。
Parameters sec: UNIXタイムスタンプ。 UNIXタイムスタンプを照会するには、time() 関数を呼び出します。
戻り値 secパラメーターで指定されたUNIXタイムスタンプに基づいて、Cookieで使用できる時間文字列を返します。
例 
say(concat('cookie_time:', cookie_time(time())))
出力：
cookie_time: 水、5月29日-19日06:02:41 GMT

http_time

この関数の詳細を次の表に示します。
項目 説明
構文 http_time (秒)
説明 UNIXタイムスタンプに基づいてHTTPヘッダーで使用できる時間文字列を生成します。 たとえば、この関数を呼び出して、Last-Modifiedヘッダーで使用できる時間文字列を生成できます。
重要 この関数によって生成される時間文字列はGMTです。
Parameters sec: UNIXタイムスタンプ。 UNIXタイムスタンプを照会するには、time() 関数を呼び出します。
戻り値 secパラメーターで指定されたUNIX timestampに基づいて、HTTPヘッダーで使用できる時間文字列を返します。
例 
say(concat('http_time:', http_time(time())))
出力：
http_time: 5月2019日水曜日06:02:41 GMT

parse_http_time

この関数の詳細を次の表に示します。
項目 説明
構文 parse_http_time(str)
説明 HTTPヘッダーで使用される時間文字列を解析し、対応するUNIXタイムスタンプを返します。
重要 この関数はタイムゾーンを認識しません。 この関数に時間を渡す前に、現地時間をGMTに変換する必要があります。
Parameters str: 解析する時間文字列。 形式: 水曜日、5月2019日06:02:41 GMT 時間文字列をクエリするには、http_time() 関数を呼び出します。
戻り値 関数が成功すると、UNIXタイムスタンプが返されます。 それ以外の場合、falseが返されます。
例 
say(concat('parse_http_time:', parse_http_time(http_time ()))))
出力：
parse_http_time:1559109761

unixtime

この関数の詳細を次の表に示します。
項目 説明
構文 構文: unixtime(year, month, day, hour, min, sec)
説明 指定された年、月、日、時、分、秒パラメーターの値に基づいて、UNIXタイムスタンプを生成して返します。
注 UNIXタイムスタンプはタイムゾーンとは無関係で、1970年1月1日の00:00:00 (UTCまたはGMT) から経過した秒数を示します。
Parameters
  • year: 年を指定します。
  • month: 月を指定します。
  • day: 日を指定します。
  • hour: 時間を指定します。
  • min: 分を指定します。
  • sec: 秒を指定します。
戻り値 UNIXタイムスタンプを返します。
例
  • 例 1：
    t = unixtime(1970, 1, 1, 8, 0, 0)
say(concat('unixtime()=', t))

    出力：

    unixtime()=0
  • 例 2：
    t = unixtime(2021,12,23,0,0,0)
say(concat('unixtime()=', t))

    出力：

    unixtime()=1640188800