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

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

Синтаксис

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
date_time_part	Строка, представляющая часть спецификации формата даты ISO 8601. Эта часть используется для указания аспекта даты извлечения и возврата.
date_time	Строка даты и времени (UTC) в формате YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.

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

Возвращает числовое значение, которое является положительным целым числом.

Примеры

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

Извлечение частей даты и времени

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

SELECT VALUE {
  getYear: DATETIMEPART("yyyy", "2016-05-29T08:30:00.1301617"),
  getMonth: DATETIMEPART("mm", "2016-05-29T08:30:00.1301617"),
  getDay: DATETIMEPART("dd", "2016-05-29T08:30:00.1301617"),
  getHour: DATETIMEPART("hh", "2016-05-29T08:30:00.1301617"),
  getMinute: DATETIMEPART("mi", "2016-05-29T08:30:00.1301617"),
  getSecond: DATETIMEPART("ss", "2016-05-29T08:30:00.1301617"),
  getMillisecond: DATETIMEPART("ms", "2016-05-29T08:30:00.1301617"),
  getMicrosecond: DATETIMEPART("mcs", "2016-05-29T08:30:00.1301617"),
  getNanosecond: DATETIMEPART("ns", "2016-05-29T08:30:00.1301617")
}

[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

Замечания

• Эта функция не использует индекс.
• Формат даты ISO 8601 указывает допустимые части даты и времени, используемые с этой функцией: | | Формат | | --- | --- | | Year | year, yyyyyy | | Месяц | month, mmm | | День | day, ddd | | Час | hour, hh | | Minute | minute, min | | Во-вторых | second, sss | | Миллисекунда | millisecond, ms | | Microsecond | microsecond, mcs | | Nanosecond | nanosecond,ns |
• Эта функция возвращается undefined по следующим причинам:
  • Указанная часть даты и времени недопустимая.
  • Дата и время не является допустимой строкой даты и времени ISO 8601 .