DateTimeAdd (NoSQL クエリ)
適用対象: 
NoSQL
指定した日時文字列に指定した数値を追加した結果である日時文字列の値を返します。
構文
DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)
引数
| 説明 | |
|---|---|
date_time_part |
ISO 8601 の日付書式指定の部分を表す文字列。 この部分は、関連する数値式によって日付のどの部分を変更するかを示すために使用されます。 |
numeric_expr |
符号付き整数の結果になる数値式。 |
date_time |
ISO 8601 形式 YYYY-MM-DDThh:mm:ss.fffffffZ での協定世界時 (UTC) 日時の文字列。 |
注意
ISO 8601 形式の詳細については、「ISO 8601」を参照してください。
戻り値の型
ISO 8601 形式 YYYY-MM-DDThh:mm:ss.fffffffZ で日時の文字列 (UTC) を返します。
例
次の例では、2020 年 7 月 3 日の午前 0 時 (00:00 UTC) にさまざまな値 (1 年、1 か月、1 日、1 時間) を追加します。 また、同じ日付からさまざまな値 (2 年、2 か月、2 日、2 時間) を減算します。 最後に、式を使用して、同じ日付の秒を変更します。
SELECT VALUE {
addOneYear: DateTimeAdd("yyyy", 1, "2020-07-03T00:00:00.0000000"),
addOneMonth: DateTimeAdd("mm", 1, "2020-07-03T00:00:00.0000000"),
addOneDay: DateTimeAdd("dd", 1, "2020-07-03T00:00:00.0000000"),
addOneHour: DateTimeAdd("hh", 1, "2020-07-03T00:00:00.0000000"),
subtractOneYear: DateTimeAdd("yyyy", -1, "2020-07-03T00:00:00.0000000"),
subtractOneMonth: DateTimeAdd("mm", -1, "2020-07-03T00:00:00.0000000"),
subtractOneDay: DateTimeAdd("dd", -1, "2020-07-03T00:00:00.0000000"),
subtractOneHour: DateTimeAdd("hh", -1, "2020-07-03T00:00:00.0000000"),
modifySecondsExpression: DateTimeAdd("ss", 5 * -5, "2020-07-03T00:00:00.0000000")
}
[
{
"addOneYear": "2021-07-03T00:00:00.0000000Z",
"addOneMonth": "2020-08-03T00:00:00.0000000Z",
"addOneDay": "2020-07-04T00:00:00.0000000Z",
"addOneHour": "2020-07-03T01:00:00.0000000Z",
"subtractOneYear": "2019-07-03T00:00:00.0000000Z",
"subtractOneMonth": "2020-06-03T00:00:00.0000000Z",
"subtractOneDay": "2020-07-02T00:00:00.0000000Z",
"subtractOneHour": "2020-07-02T23:00:00.0000000Z",
"modifySecondsExpression": "2020-07-02T23:59:35.0000000Z"
}
]
解説
- この関数は、次の理由から
undefinedを返します。- 指定された日付と時刻の部分が無効です。
- 数値式が有効な整数ではありません。
- 引数の日時が、有効な ISO 8601 日時文字列ではありません。
- ISO 8601 日付形式は、この関数で使用する有効な日付と時刻の部分を指定します。| | 形式 | | --- | --- | | 年 |
year、yyyy、yy| | 月 |month、mm、m| | 日 |day、dd、d| | 時 |hour、hh| | 分 |minute、mi、n| | 秒 |second、ss、s| | ミリ秒 |millisecond、ms| | マイクロ秒 |microsecond、mcs| | ナノ秒 |nanosecond、ns|