DATETIMEFROMPARTS — язык запросов в Cosmos DB (в Azure и Fabric)

Функция DATETIMEFROMPARTS возвращает значение строки даты и времени, созданное из входных числовых значений для различных частей даты и времени.

Синтаксис

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

Arguments

	Description
numeric_year	Положительное числовой целочисленное значение года (формат yyy формата ISO 8601).
numeric_month	Положительное числовой целочисленное значение месяца (формат ISO 8601 мм).
numeric_day	Положительное числовое целочисленное значение дня (формат ISO 8601 dd).
numeric_hour	Необязательное положительное числовое целое число в течение часа (hh формата ISO 8601). Если значение не указано, значение по умолчанию равно 0.
numeric_minute	Необязательное положительное числовое целое число в минуту (мм формата ISO 8601). Если значение не указано, значение по умолчанию равно 0.
numeric_second	Необязательное положительное числовое целое число для второго (формат ISO 8601 ss). Если значение не указано, значение по умолчанию равно 0.
numeric_second_fraction	Необязательное положительное числовое целое число для дробного числа секунды (формат FffffffZ iso 8601). Если значение не указано, значение по умолчанию равно 0.

Типы возвращаемых данных

Возвращает значение строки даты и времени.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Создание даты и времени из частей

В этом примере DATETIMEFROMPARTS функция используется для создания значений даты и времени из различных аргументов.

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

Замечания

• Если указанные целые числа будут создавать недопустимые дату и время, функция возвращается undefined.