適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
指定した期間から新しい datetime を計算し、指定した datetimeから加算または減算します。
構文
datetime_add(
period,amount,datetime)
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| 時代 | string |
✔️ | インクリメントする時間の長さ。 |
| 量 | int |
✔️ | datetime に加算または減算する期間の数。 |
| datetime | datetime |
✔️ | 時間 x amount計算の結果でインクリメントする日付。 |
有効 期間 の値:
- 年
- 四半期
- 月
- 週
- 日付
- 時間
- 分
- 秒
- ミリセカント
- マイクロ秒
- ナノセカンド
返品
特定の時刻/日付間隔が追加された後の datetime を返します。
例
次の例は、関数を使用して datetime_add 値に期間を追加する方法を示しています。
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))
出力
| 年 | 四半期 | 月 | 週間 | 日 | 時間 | 分 | 秒 |
|---|---|---|---|---|---|---|---|
| 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 |
次の例では、 datetime_add 関数を使用して、特定の日付から時間間隔を加算または減算する方法を示します。
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))
出力
| 年 | 四半期 | 月 | 週間 |
|---|---|---|---|
| 2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |