Позволяет хранить момент времени, который можно представить в виде календарной даты и времени суток.
Синтаксис:
Поддерживаемый диапазон значений: [1970-01-01 00:00:00, 2106-02-07 06:28:15].
Разрешение: 1 секунда.
Тип данных Date работает быстрее, чем DateTime, в большинстве случаев.
Для хранения типа Date требуется 2 байта, а для DateTime — 4. Однако при сжатии разница в размере между Date и DateTime становится еще заметнее. Это связано с тем, что минуты и секунды в DateTime сжимаются хуже. Фильтрация и агрегация по Date вместо DateTime также выполняются быстрее.
Момент времени сохраняется как Unix-временная метка независимо от часового пояса или перехода на летнее время. Часовой пояс влияет на то, как значения типа DateTime отображаются в текстовом формате и как разбираются значения, заданные в виде строк (2020-01-01 05:00:01).
В таблицах хранится Unix-временная метка, не зависящая от часового пояса, а сам часовой пояс используется для преобразования её в текстовый формат и обратно при импорте/экспорте данных, а также для выполнения календарных вычислений над значениями (например, функциями toDate, toHour и т. д.). Часовой пояс не хранится в строках таблицы (или в наборе результатов), а сохраняется в метаданных столбца.
Список поддерживаемых часовых поясов можно найти в IANA Time Zone Database, а также получить запросом SELECT * FROM system.time_zones. Этот список также доступен в Википедии.
Вы можете явно задать часовой пояс для столбцов типа DateTime при создании таблицы. Пример: DateTime('UTC'). Если часовой пояс не задан, ClickHouse использует значение параметра timezone в настройках сервера или в настройках операционной системы на момент запуска сервера ClickHouse.
По умолчанию clickhouse-client использует часовой пояс сервера, если при инициализации типа данных часовой пояс явно не задан. Чтобы использовать часовой пояс клиента, запустите clickhouse-client с параметром --use_client_time_zone.
ClickHouse выводит значения в зависимости от значения настройки date_time_output_format. По умолчанию используется текстовый формат YYYY-MM-DD hh:mm:ss. Кроме того, формат вывода можно изменить с помощью функции formatDateTime.
При вставке данных в ClickHouse можно использовать разные форматы строк даты и времени в зависимости от значения настройки date_time_input_format.
1. Создание таблицы со столбцом типа DateTime и вставка данных в неё:
- При вставке datetime в виде целого числа оно интерпретируется как Unix-временная метка (UTC).
1546300800 соответствует '2019-01-01 00:00:00' UTC. Однако, поскольку для столбца timestamp указан часовой пояс Asia/Istanbul (UTC+3), при выводе в виде строки значение будет отображаться как '2019-01-01 03:00:00'
- При вставке строкового значения как datetime оно интерпретируется как значение в часовом поясе столбца.
'2019-01-01 00:00:00' будет интерпретироваться как значение в часовом поясе Asia/Istanbul и сохранено как 1546290000.
2. Фильтрация значений DateTime
Значения столбца DateTime можно фильтровать с помощью строкового значения в условии WHERE. Оно будет автоматически преобразовано в DateTime:
3. Определение часового пояса для столбца типа DateTime:
4. Преобразование часовых поясов
Поскольку при преобразовании часового пояса изменяются только метаданные, эта операция не требует вычислительных ресурсов.
Ограничения поддержки часовых поясов
Обработка перехода на летнее время (DST)
date_time_output_format установлен в simple.- Часы переводятся назад (“Fall Back”), из-за чего возникает перекрытие в один час.
- Часы переводятся вперед (“Spring Forward”), из-за чего образуется пропуск в один час.
По умолчанию ClickHouse всегда выбирает более ранний вариант при перекрытии времени и может интерпретировать несуществующие значения времени при переводе часов вперед.
Например, рассмотрим следующий переход с летнего времени (DST) на стандартное.
- 29 октября 2023 года в 02:00:00 часы переводятся назад на 01:00:00 (BST → GMT).
- Интервал 01:00:00 – 01:59:59 встречается дважды (один раз в BST и один раз в GMT).
- ClickHouse всегда выбирает первый вариант (BST), что может приводить к неожиданным результатам при добавлении временных интервалов.
Аналогично, при переходе со стандартного времени на летнее может показаться, что один час как будто пропадает.
Например:
- 26 марта 2023 года в
00:59:59 часы переводятся вперёд на 02:00:00 (GMT → BST).
- Часа
01:00:00 – 01:59:59 не существует.
В этом случае ClickHouse сдвигает несуществующее время 2023-03-26 01:30:00 назад — к 2023-03-26 00:30:00.
Последнее изменение 2 июля 2026 г.
