Udostępnij za pośrednictwem

DateTimeFromParts (zapytanie NoSQL)

  • Artykuł

DOTYCZY: NoSQL

Zwraca wartość ciągu daty i godziny skonstruowaną na podstawie wejściowych wartości liczbowych dla różnych części daty i godziny.

Składnia

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

Argumenty

opis
numeric_year Dodatnia wartość liczbowa całkowita dla roku. Ten argument jest w formacie yyyyISO 8601 .
numeric_month Dodatnia wartość liczbowa całkowita dla miesiąca. Ten argument jest w formacie mmISO 8601 .
numeric_day Dodatnia wartość liczbowa całkowita dla dnia. Ten argument jest w formacie ddISO 8601 .
numeric_hour(Opcjonalnie) Opcjonalna dodatnia wartość liczbowa całkowita dla godziny. Ten argument jest w formacie hhISO 8601 . Jeśli nie zostanie określony, wartość domyślna to 0.
numeric_minute(Opcjonalnie) Opcjonalna dodatnia wartość całkowita liczbowa dla minuty. Ten argument jest w formacie mmISO 8601 . Jeśli nie zostanie określony, wartość domyślna to 0.
numeric_second(Opcjonalnie) Opcjonalna dodatnia wartość liczbowa całkowita dla sekundy. Ten argument jest w formacie ssISO 8601 . Jeśli nie zostanie określony, wartość domyślna to 0.
numeric_second_fraction(Opcjonalnie) Opcjonalna dodatnia wartość liczbowa całkowita dla ułamka sekundy. Ten argument jest w formacie fffffffZISO 8601 . Jeśli nie zostanie określony, wartość domyślna to 0.

Uwaga

Aby uzyskać więcej informacji na temat formatu ISO 8601, zobacz ISO 8601.

Typy zwracane

Zwraca ciąg daty i godziny UTC w formacie YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Przykłady

W poniższym przykładzie użyto różnych kombinacji argumentów do utworzenia ciągów daty i godziny. W tym przykładzie użyto daty i godziny 20 kwietnia 2017 r. 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"
  }
]

Uwagi

  • Jeśli określone liczby całkowite spowodują utworzenie nieprawidłowej daty i godziny, funkcja zwróci undefinedwartość .

Powiązana zawartość