datetime_add()

指定した期間から新しい datetime を 計算し、指定した datetime に対して、指定した量を掛け、加算または減算します。

構文

datetime_add(period,amount,datetime)

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
期間	string	✔️	インクリメントする時間の長さ。
量	int	✔️	datetime に加算または減算する期間の数。
datetime	datetime	✔️	期間 x 金額計算の結果でインクリメントする日付。

period に指定可能な値:

• Year
• Quarter
• Month
• 週
• 日間
• Hour
• 分
• Second
• Millisecond
• Microsecond
• Nanosecond

戻り値

特定の時刻/日付間隔が追加された後の datetime 。

例

期間

クエリを実行する

print  year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))

出力

year	quarter	month	week	day	hour	minute	second
2018-01-01 00:00:00.0000000	2017-04-01 00:00:00.0000000	2017-02-01 00:00:00.0000000	2017-01-08 00:00:00.0000000	2017-01-02 00:00:00.0000000	2017-01-01 01:00:00.0000000	2017-01-01 00:01:00.0000000	2017-01-01 00:00:01.0000000

Amount

クエリを実行する

print  year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))

出力

year	quarter	month	week
2012-01-01T00:00:00Z	2020-01-01T00:00:00Z	2015-10-01T00:00:00Z	2018-12-02T00:00:00Z