Бөлісу құралы:

DateTimeFromParts (запрос NoSQL)

  • Мақала

ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL

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

Синтаксис

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

Аргументы

Description
numeric_year Положительное числовое целое число в течение года. Этот аргумент находится в формате yyyyISO 8601.
numeric_month Положительное числовой целочисленное значение месяца. Этот аргумент находится в формате mmISO 8601.
numeric_day Положительное числовое целое число в течение дня. Этот аргумент находится в формате ddISO 8601.
numeric_hour(Необязательно) Необязательное положительное числовое целое число в течение часа. Этот аргумент находится в формате hhISO 8601. Если не задано, по умолчанию используется значение 0.
numeric_minute(Необязательно) Необязательное положительное числовое целое число в минуту. Этот аргумент находится в формате mmISO 8601. Если не задано, по умолчанию используется значение 0.
numeric_second(Необязательно) Необязательное положительное числовое целое число для второго. Этот аргумент находится в формате ssISO 8601. Если не задано, по умолчанию используется значение 0.
numeric_second_fraction(Необязательно) Необязательное положительное числовое целое число для дробного числа секунды. Этот аргумент находится в формате fffffffZISO 8601. Если не задано, по умолчанию используется значение 0.

Примечание.

Дополнительные сведения о формате ISO 8601 см . в статье ISO 8601.

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

Возвращает строку даты и времени UTC в формате YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

Примеры

В следующем примере используются различные сочетания аргументов для создания строк даты и времени. В этом примере используется дата и время 20 апреля 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"
  }
]

Замечания

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

Связанный контент