Bagikan melalui


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.fffffffZISO 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.fffffffZISO 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 |