Treasure Data TD_TIME関数チートシート

28029 ワード

hive Presto TD_TIME関数 TreasureData hive テキストリンク

TD_TIME関数チートシート

Treasure DataのTD_TIME関数をまとめました。

TD_TIME_RANGE

戻り値：boolean

引数

引数	型	設定値
1	int/long	time UNIXTIME
2	int/long/string	start_time 文字列またはUNIXTIMEで指定可能
3	int/long/string	end_time 文字列またはUNIXTIMEで指定可能
4(option)	string default_timezone = 'UTC'	タイムゾーン

第1引数timeがstart_time以下で、end_timeより古い場合（start_time <= time && time <end_time）にtrueを返します。
end_timeが省略されているかNULLの場合は、未来全て。 start_timeがNULLの場合、過去全てが対象となります。

例

SELECT文は省略
WHEREに指定する例
  TD_TIME_RANGE(time, '2021-01-01', '2021-01-02','JST')  --日付で期間指定
  TD_TIME_RANGE(time, '2021-01-01 JST')                  --日付以降指定
  TD_TIME_RANGE(time, NULL, '2021-01-01', 'JST')         --To指定 
  TD_TIME_RANGE(time, '2021-01-01', NULL, 'JST')         --From指定
  TD_TIME_RANGE(time, '2021-03-01 09:00:00','2021-03-22 18:00:00','JST')  --日時で期間指定
  TD_TIME_RANGE(time,1609426800,1617116400,'JST')  --期間指定 unix_timestampで指定

TD_SCHEDULED_TIME

戻り値：long(UNIXTIME)

引数：なし

TDのSaved Queryのスケジュール機能によって、ジョブがスケジュールされた日時を返します。実際のクエリ開始時間が遅れる可能性があるため、戻り値はNOW（）とは異なる場合があります。
クエリがスケジュールされたクエリでない場合、ジョブが発行された時刻を返します。

例

SELECT TD_SCHEDULED_TIME() ---> スケジュールをcron(44 * * * *)で実行の場合、1616388240 (2021-03-22 13:44:00+0900)
SELECT TD_SCHEDULED_TIME() ---> スケジュールをhourlyで実行の場合、1616392800 (2021-03-22 15:00:00+0900)

Saved Queryにスケジュールが設定されていない場合、RUNをクリックするとダイアログボックスが表示され、TD_SCHEDULED_TIMEに設定する日時の登録を行うことになります。

TD_INTERVAL

戻り値：boolean

引数

引数	型	設定値
1	int/long	time UNIXTIME
2	string	interval
3(option)	string default_timezone = 'UTC'	タイムゾーン

TD_INTERVALは、相対的な時間範囲を計算するために使用されます。（絶対的な時間範囲の指定は、TD_TIME_RANGEを使用します。）

例

SELECT文は省略、タイムゾーンはJST
WHERE 
TD_INTERVAL(time, '-30s','JST')  --クエリ実行から30秒前
TD_INTERVAL(time, '-15m','JST')  --クエリ実行から15分前
TD_INTERVAL(time, '-1h','JST')   --クエリ実行から1時間前
TD_INTERVAL(time, '-1w','JST')   --クエリ実行から1週間前
TD_INTERVAL(time, '-1M','JST')   --クエリ実行から1ヶ月前
TD_INTERVAL(time,'-7d','JST')    --クエリ実行から7日前
TD_INTERVAL(time, '-1h/now','JST') --今から1時間前
TD_INTERVAL(time, '-1h/0d','JST') --今日の初め(2020-03-22 0:00:00)から1時間前
D_INTERVAL(time, '-7d/2021-03-31','JST') --2021-03-31から7日前
TD_INTERVAL(time, '-10d/-1M','JST') --クエリ実行の1分前から10日前

TD_INTERVAL_RANGE

戻り値:ARRAY[(start time), (end time)]

引数

引数	型	設定値
1	string	interval_string
2(option)	string default_timezone = 'UTC'	timezone タイムゾーン

TD_INTERVALの日時範囲を確認するために使用することができます。

例（2021-03-22(JST)にクエリ実行)


SELECT TD_INTERVAL_RANGE('-30s','JST') ---> List [ "2021-03-22 15:53:52+0900", "2021-03-22 15:54:22+0900" ]
SELECT TD_INTERVAL_RANGE('-15m','JST') ---> List [ "2021-03-22 15:42:00+0900", "2021-03-22 15:57:00+0900" ]  --クエリ実行から15分前
SELECT TD_INTERVAL_RANGE('-1h','JST')  ---> List [ "2021-03-22 14:00:00+0900", "2021-03-22 15:00:00+0900" ]  --クエリ実行から1時間前
SELECT TD_INTERVAL_RANGE('-1w','JST')  ---> List [ "2021-03-15 00:00:00+0900", "2021-03-22 00:00:00+0900" ]  --クエリ実行から1週間前
SELECT TD_INTERVAL_RANGE('-1M','JST')  ---> List [ "2021-02-01 00:00:00+0900", "2021-03-01 00:00:00+0900" ]  --クエリ実行から1ヶ月前
SELECT TD_INTERVAL_RANGE('-7d','JST')  ---> List [ "2021-03-15 00:00:00+0900", "2021-03-22 00:00:00+0900" ]   --クエリ実行から7日前
SELECT TD_INTERVAL_RANGE('-1h/now','JST') ---> List [ "2021-03-22 15:00:00+0900", "2021-03-22 16:05:19+0900" ] --今から1時間前
SELECT TD_INTERVAL_RANGE('-1h/0d','JST') ---> List [ "2021-03-21 23:00:00+0900", "2021-03-22 00:00:00+0900" ]  --今日の初め(2020-03-22 0:00:00)から1時間前
SELECT TD_INTERVAL_RANGE('-7d/2021-03-31','JST') ---> List [ "2021-03-24 00:00:00+0900", "2021-03-31 00:00:00+0900" ] --2021-03-31から7日前
SELECT TD_INTERVAL_RANGE('-10d/-1M','JST') ---> List [ "2021-01-22 00:00:00+0900", "2021-02-01 00:00:00+0900" ] --クエリ実行の1ヶ月前から10日前

TD_TIME_ADD

戻り値：long(UNIXTIME)

引数

引数	型	設定値
1	int/long/string	time
2	string	duration
3(option)	string default_timezone = 'UTC'	タイムゾーン

timeに設定した日時からdurationに設定した時間オフセットの日時をUNIXTIMEで返します。
パフォーマンスを考慮し、「年(y)」と「月(m)」は、サポートされていません。

例

SELECT TD_TIME_ADD('2021-03-22 09:00:00', '1s') ---> 1616403601 (2021-03-22 09:00:01+0000)
SELECT TD_TIME_ADD('2021-03-22 09:00:00', '-1s','JST') ---> 1616371199 (2021-03-22 08:59:59+0900)
SELECT TD_TIME_ADD('2021-03-22 09:00:00', '-1m','JST') ---> 1616371140 (2021-03-22 08:59:00+0900)
SELECT TD_TIME_ADD('2021-03-22 09:00:00', '-1h','JST') ---> 1616367600 (2021-03-22 08:00:00+0900)
SELECT TD_TIME_ADD('2021-03-22 09:00:00', '-1d','JST') ---> 1616284800 (2021-03-21 09:00:00+0900)
SELECT TD_TIME_ADD('2021-03-22 09:00:00', '-1w','JST') ---> 1615766400 (2021-03-15 09:00:00+0900)

TD_TIME_FORMAT

戻り値：string(日時の文字列)

引数

引数	型	設定値
1	long	time
2	string	format
3(option)	string default_timezone = 'UTC'	タイムゾーン

UNIXTIMEを指定した形式の日時の文字列に変換します。（使用可能な形式については、Supported Time Formats in TD_TIME_FORMAT UDFを参照ください。）

例

SELECT TD_TIME_FORMAT(1616371200, 'yyyy-MM-dd HH:mm:ss', 'JST') ---> 2021-03-22 09:00:00
SELECT TD_TIME_FORMAT(1616371200, 'yyyy-MM-dd HH:mm:ss z', 'JST') ---> 2021-03-22 09:00:00 GMT+09:00
SELECT TD_TIME_FORMAT(1616371200, 'yyyy-MM-dd HH:mm:ss.SSS', 'JST') ---> 2021-03-22 09:00:00.000

その他はSupported Time Formats in TD_TIME_FORMAT UDFをご参照ください。

TD_TIME_PARSE

戻り値：long(UNIXTIME)

引数

引数	型	設定値
1	string	time 日時の文字列
2(option)	string default_timezone = 'UTC'	タイムゾーン

日時の文字列をUNIXタイムスタンプに変換します。

例

SELECT TD_TIME_PARSE('2021-03-22 09:00:00') ---> 1616403600
SELECT TD_TIME_PARSE('2021-03-22 09:00:00','JST') ---> 1616371200
SELECT TD_TIME_PARSE('2021-03-22') ---> 1616371200 (2021-03-22 00:00:00+0000)
SELECT TD_TIME_PARSE('2021-03-22','JST') ---> 1616338800 (2021-03-22 00:00:00+0900)

TD_TIME_STRING

戻り値：string(日時の文字列)

引数

引数	型	設定値
1	long	time UNIXTIME
2	string	format string ドキュメントを参照
3(option)	string default_timezone = 'UTC'	タイムゾーン

指定したUNIXTIMEを指定されたformat stringの文字列に変換します。

例

TD_TIME_STRING(1611657186,'s','JST') ---> 2021-01-26 19:33:06+0900
TD_TIME_STRING(1611657186,'s!','JST') --> 2021-01-26 19:33:06
TD_TIME_STRING(1611657186,'m','JST') ---> 22021-01-26 19:33:00+0900
TD_TIME_STRING(1611657186,'m!','JST') --> 2021-01-26 19:33

TD_DATE_TRUNC

戻り値：long(UNIXTIME)

引数

引数	型	設定値
1	string	unit
2	long	time UNIXTIME
3(option)	string default_timezone = 'UTC'	タイムゾーン

unitに指定した日時のレベルで、日時を切り捨てし、UNIXTIMEで返します。

例

SELECT TD_DATE_TRUNC('minute', 1616385696) #2021-03-22 04:01:36+0000 ---> 1616385660 (2021-03-22 04:01:00+0000) 分で切り捨て
SELECT TD_DATE_TRUNC('hour', 1616385696) #2021-03-22 04:01:36+0000 ---> 1616385600 (2021-03-22 04:00:00+0000) 時で切り捨て
SELECT TD_DATE_TRUNC('day', 1616385696) #2021-03-22 04:01:36+0000 ---> 1616371200 (2021-03-22 00:00:00+0000) 日で切り捨て
SELECT TD_DATE_TRUNC('week', 1616385696) #2021-03-22 04:01:36+0000 ---> 1616371200 (2021-03-22 00:00:00+0000) 週で切り捨て
SELECT TD_DATE_TRUNC('month', 1616385696) #2021-03-22 04:01:36+0000 ---> 1614556800 (2021-03-01 00:00:00+0000) 月で切り捨て
SELECT TD_DATE_TRUNC('quarter', 1616385696) #2021-03-22 04:01:36+0000 ---> 1609459200 (2021-01-01 00:00:00+0000) 四半期で切り捨て
SELECT TD_DATE_TRUNC('year', 1616385696) #2021-03-22 04:01:36+0000 ---> 1609459200 (2021-01-01 00:00:00+0000) 年で切り捨て
SELECT TD_DATE_TRUNC('minute', 1616385696,'JST') #2021-03-22 13:01:36+0900 ---> 1616385660 (2021-03-22 13:01:00+0900) 分で切り捨て、タイムゾーン指定

参考

Author And Source

この問題について(Treasure Data TD_TIME関数チートシート), 我々は、より多くの情報をここで見つけました https://qiita.com/AkiQ/items/20c4bed4bd2ba3aa0ea0

著者帰属：元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。

Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .

選択システムc++設計と実現