DATETIMEFROMPARTS - Cosmos DB'de sorgu dili (Azure ve Doku'da)

İşlev, DATETIMEFROMPARTS çeşitli tarih ve saat bölümleri için giriş sayısal değerlerinden bir tarih ve saat dizesi değeri döndürür.

Sözdizimi

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

Arguments

Description
numeric_year Yıl için pozitif sayısal tamsayı değeri (ISO 8601 biçim yyyy).
numeric_month Ay için pozitif bir sayısal tamsayı değeri (ISO 8601 biçim mm).
numeric_day Gün için pozitif bir sayısal tamsayı değeri (ISO 8601 biçim dd).
numeric_hour Saat için isteğe bağlı pozitif sayısal tamsayı değeri (ISO 8601 biçim ss). Belirtilmezse, varsayılan değer 0'dır.
numeric_minute Dakika için isteğe bağlı pozitif sayısal tamsayı değeri (ISO 8601 biçim mm). Belirtilmezse, varsayılan değer 0'dır.
numeric_second İkinci için isteğe bağlı pozitif sayısal tamsayı değeri (ISO 8601 biçim ss). Belirtilmezse, varsayılan değer 0'dır.
numeric_second_fraction Saniyenin kesirli değeri için isteğe bağlı pozitif sayısal tamsayı değeri (ISO 8601 biçimi fffffffZ). Belirtilmezse, varsayılan değer 0'dır.

Dönüş türleri

Tarih ve saat dizesi değeri döndürür.

Örnekler

Bu bölüm, bu sorgu dili yapısının nasıl kullanılacağına örnekler içerir.

Parçalardan tarih ve saat oluşturma

Bu örnekte işlev, DATETIMEFROMPARTS çeşitli bağımsız değişkenlerden tarih ve saat değerleri oluşturmak için kullanılır.

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

Açıklamalar

  • Belirtilen tamsayılar geçersiz bir tarih ve saat oluşturursa, işlevi döndürür undefined.