EQLには、式を使用して時間、日付または期間を表すタイムスタンプを作成する関数があります。
式が文字列の場合、特定の書式である必要があります。 書式が無効、または値が範囲外の場合、その結果はNULLになります。
前述の「形式」列で示されているように、TO_TIME
およびTO_DATETIME
ではタイム・ゾーン・オフセットを受け入れます。 ただし、EQLではオフセット値は格納されません。 かわりに、GMTタイム・ゾーンに正規化された値を格納します。
式 | 正規化された値 |
---|---|
TO_DATETIME('2016-07-21T16:00:00.000+02:00')
|
2016-07-21T14:00:00.000Z |
TO_DATETIME('2016-07-31T20:00:00.000-06:00')
|
2016-08-01T02:00:00.000Z |
TO_DATETIME('2016-06-15T20:00:00.000Z')
|
2016-06-15T20:00:00.000Z |
TO_TIME('23:00:00.000+03:00')
|
20:00:00.000Z |
TO_TIME('15:00:00.000-10:00')
|
01:00:00.000Z |
TO_DATETIME形式
TO_DATETIME(<DateTimeString>)説明:
<DateTimeString> ::= [-]YYYY-MM-DDT<TimeStringFormat>
前述の表に、文字列インタフェースの3つの例を示します。
TO_DATETIME(<Year>, <Month>, <Day>) TO_DATETIME(<Year>, <Month>, <Day>, <Hour>, <Minute>, <Second>, <Millisecond>)この場合、すべての引数は整数です。
最初のシグネチャでは、時間引数はゼロで埋められます。 どちらのシグネチャでも、タイム・ゾーンはUTCであるとみなされます。 タイムゾーン情報が存在する場合、次の例に示すように、期間(TO_DURATION
)およびタイムゾーン(TO_TZ
)構成を使用できます。
TO_DATETIME(2016, 7, 22) TO_DATETIME(2016, 7, 22, 23, 15, 50, 500) TO_DATETIME(2016, 7, 22, 23, 15, 50, 500) + TO_DURATION(1000) TO_TZ(TO_DATETIME(2016, 7, 22, 23, 15, 50, 500), 'America/New_York')