Поделиться через

DateTimeBin (запрос NoSQL)

  • Статья

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

Возвращает значение строки даты и времени, которое является результатом бининга (или округления) части предоставленной строки даты и времени.

Синтаксис

DateTimeBin(<date_time> , <date_time_part> [, <bin_size>] [, <bin_start_date_time>])

Аргументы

Description
date_time Строка даты и времени (UTC) в формате YYYY-MM-DDThh:mm:ss.fffffffZISO 8601.
date_time_part Строка, представляющая часть спецификации формата даты ISO 8601. Эта часть используется для указания того, какой аспект даты в ячейку. В частности, этот аргумент части представляет уровень детализации для бининга (или округления). Минимальная степень детализации для части составляет дни, а максимальная степень детализации — наносекунда.
bin_size(Необязательно) Необязательное числовое значение, указывающее размер ячейки. Если не задано, по умолчанию используется значение 1.
bin_start_date_time(Необязательно) Необязательная строка универсального времени (UTC) в формате YYYY-MM-DDThh:mm:ss.fffffffZISO 8601. Этот аргумент даты и времени указывает дату начала для ячейки. Если значение не указано, значение по умолчанию — эпоха 1970-01-01T00:00:00.000000ZUnix.

Примечание.

Дополнительные сведения о формате ISO 8601 см . в статье ISO 8601. Дополнительные сведения об эпохе Unix см. в разделе "Время Unix".

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

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

Примеры

В следующем примере приведен пример даты 8 января 2021 г. в 18:35 UTC по различным значениям. В примере также изменяется размер ячейки, а также дата и время начала ячейки.

SELECT VALUE {
    binDay: DateTimeBin("2021-01-08T18:35:00.0000000", "dd"),
    binHour: DateTimeBin("2021-01-08T18:35:00.0000000", "hh"),
    binSecond: DateTimeBin("2021-01-08T18:35:00.0000000", "ss"),
    binFiveHours: DateTimeBin("2021-01-08T18:35:00.0000000", "hh", 5),
    binSevenDaysUnixEpoch: DateTimeBin("2021-01-08T18:35:00.0000000", "dd", 7),
    binSevenDaysWindowsEpoch: DateTimeBin("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}

[
  {
    "binDay": "2021-01-08T00:00:00.0000000Z",
    "binHour": "2021-01-08T18:00:00.0000000Z",
    "binSecond": "2021-01-08T18:35:00.0000000Z",
    "binFiveHours": "2021-01-08T15:00:00.0000000Z",
    "binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
    "binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
  }
]

Замечания

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

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