DATETIMEADD - Bahasa kueri di Cosmos DB (di Azure dan Fabric)

Fungsi mengembalikan DATETIMEADD nilai string tanggal dan waktu yang merupakan hasil dari penambahan nilai angka tertentu ke string tanggal dan waktu yang disediakan.

Syntax

DATETIMEADD(<date_time_part>, <numeric_expr>, <date_time>)

Arguments

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

Tipe pengembalian

Mengembalikan string tanggal dan waktu UTC dalam format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Menambahkan dan mengurangi bagian tanggal

Dalam contoh ini, DATETIMEADD fungsi digunakan untuk menambahkan dan mengurangi tahun, bulan, hari, dan jam dari tanggal.

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"
  }
]

Komentar

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