DateTimeFromParts (kueri NoSQL)

BERLAKU UNTUK: NoSQL

Mengembalikan nilai string tanggal dan waktu yang dibangun dari nilai numerik input untuk berbagai bagian tanggal dan waktu.

Sintaks

DateTimeFromParts(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>]  [, <numeric_minute>]  [, <numeric_second>] [, <numeric_second_fraction>])

Argumen

Deskripsi
numeric_year Nilai bilangan bulat numerik positif untuk tahun ini. Argumen ini dalam format yyyyISO 8601 .
numeric_month Nilai bilangan bulat numerik positif untuk bulan tersebut. Argumen ini dalam format mmISO 8601 .
numeric_day Nilai bilangan bulat numerik positif untuk hari itu. Argumen ini dalam format ddISO 8601 .
numeric_hour(Opsional) Nilai bilangan bulat numerik positif opsional untuk jam tersebut. Argumen ini dalam format hhISO 8601 . Jika tidak ditentukan, nilai defaultnya adalah 0.
numeric_minute(Opsional) Nilai bilangan bulat numerik positif opsional untuk menit tersebut. Argumen ini dalam format mmISO 8601 . Jika tidak ditentukan, nilai defaultnya adalah 0.
numeric_second(Opsional) Nilai bilangan bulat numerik positif opsional untuk yang kedua. Argumen ini dalam format ssISO 8601 . Jika tidak ditentukan, nilai defaultnya adalah 0.
numeric_second_fraction(Opsional) Nilai bilangan bulat numerik positif opsional untuk pecahan detik. Argumen ini dalam format fffffffZISO 8601 . Jika tidak ditentukan, nilai defaultnya adalah 0.

Catatan

Untuk informasi selengkapnya tentang format ISO 8601, lihat ISO 8601.

Jenis yang ditampilkan

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

Contoh

Contoh berikut menggunakan berbagai kombinasi argumen untuk membuat string tanggal dan waktu. Contoh ini menggunakan tanggal dan waktu 20 April 2017 13:15 UTC.

SELECT VALUE {
    constructMinArguments: DateTimeFromParts(2017, 4, 20),
    constructMinEquivalent: DateTimeFromParts(2017, 4, 20, 0, 0, 0, 0),
    constructAllArguments: DateTimeFromParts(2017, 4, 20, 13, 15, 20, 3456789),
    constructPartialArguments: DateTimeFromParts(2017, 4, 20, 13, 15),
    constructInvalidArguments: DateTimeFromParts(-2000, -1, -1)
}
[
  {
    "constructMinArguments": "2017-04-20T00:00:00.0000000Z",
    "constructMinEquivalent": "2017-04-20T00:00:00.0000000Z",
    "constructAllArguments": "2017-04-20T13:15:20.3456789Z",
    "constructPartialArguments": "2017-04-20T13:15:00.0000000Z"
  }
]

Keterangan

  • Jika bilangan bulat yang ditentukan akan membuat tanggal dan waktu yang tidak valid, fungsi akan mengembalikan undefined.