Udostępnij przez

DATETIMEFROMPARTS — Język zapytań w usłudze Cosmos DB (na platformie Azure i w sieci szkieletowej)

  • Dotyczy: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

Funkcja DATETIMEFROMPARTS 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>])

Arguments

Description
numeric_year Dodatnia wartość liczbowa całkowita dla roku (format ISO 8601 rrrr).
numeric_month Dodatnia wartość liczbowa całkowita dla miesiąca (format ISO 8601 mm).
numeric_day Dodatnia wartość liczbowa całkowita dla dnia (format ISO 8601 dd).
numeric_hour Opcjonalna dodatnia wartość liczbowa całkowita dla godziny (hh formatu ISO 8601). Jeśli nie zostanie określony, wartość domyślna to 0.
numeric_minute Opcjonalna dodatnia wartość liczbowa całkowita dla minuty (format ISO 8601 mm). Jeśli nie zostanie określony, wartość domyślna to 0.
numeric_second Opcjonalna dodatnia wartość liczbowa liczby całkowitej dla sekundy (format ISO 8601 ss). Jeśli nie zostanie określony, wartość domyślna to 0.
numeric_second_fraction Opcjonalna dodatnia wartość liczbowa liczbowa dla ułamka sekundy (fffffffZ w formacie ISO 8601). Jeśli nie zostanie określony, wartość domyślna to 0.

Typy zwracane

Zwraca wartość ciągu daty i godziny.

Przykłady

Ta sekcja zawiera przykłady użycia tej konstrukcji języka zapytań.

Konstruowanie daty i godziny z części

W tym przykładzie DATETIMEFROMPARTS funkcja służy do konstruowania wartości daty i godziny z różnych argumentów.

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ść .
  • Last updated on