DateTimeAdd (kueri NoSQL)
BERLAKU UNTUK: NoSQL
Mengembalikan nilai string tanggal dan waktu yang merupakan hasil penambahan nilai angka tertentu ke string tanggal dan waktu yang disediakan.
Sintaks
DateTimeAdd(<date_time_part>, <numeric_expr> ,<date_time>)
Argumen
Deskripsi | |
---|---|
date_time_part |
String yang mewakili bagian dari spesifikasi format tanggal ISO 8601. Bagian ini digunakan untuk menunjukkan aspek tanggal mana yang akan diubah oleh ekspresi numerik terkait. |
numeric_expr |
Ekspresi numerik yang menghasilkan bilangan bulat yang ditandatangani. |
date_time |
String tanggal dan waktu Waktu Universal Terkoordinasi (UTC) dalam format YYYY-MM-DDThh:mm:ss.fffffffZ ISO 8601 . |
Catatan
Untuk informasi selengkapnya tentang format ISO 8601, lihat ISO 8601.
Jenis yang dikembalikan
Mengembalikan string tanggal dan waktu UTC dalam format YYYY-MM-DDThh:mm:ss.fffffffZ
ISO 8601 .
Contoh
Contoh berikut menambahkan berbagai nilai (satu tahun, satu bulan, satu hari, satu jam) ke tanggal 3 Juli 2020 pada tengah malam (00:00 UTC). Contoh ini juga mengurangi berbagai nilai (dua tahun, dua bulan, dua hari, dua jam) dari tanggal yang sama. Terakhir, contoh ini menggunakan ekspresi untuk memodifikasi detik dari tanggal yang sama.
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"
}
]
Keterangan
- Fungsi ini kembali
undefined
karena alasan berikut:- Bagian tanggal dan waktu yang ditentukan tidak valid.
- Ekspresi numerik bukan bilangan bulat yang valid.
- Tanggal dan waktu dalam argumen bukan string tanggal dan waktu ISO 8601 yang valid.
- Format tanggal ISO 8601 menentukan bagian tanggal dan waktu yang valid untuk digunakan dengan fungsi ini: | | Format | | --- | --- | | Tahun |
year
,yyyy
,yy
| | Bulan |month
,mm
,m
| | Hari |day
,dd
,d
| | Jam |hour
,hh
| | Menit |minute
,mi
,n
| | Kedua |second
,ss
,s
| | Milidetik |millisecond
,ms
| | Microsecond |microsecond
,mcs
| | Nanodetik |nanosecond
,ns
|