Permite almacenar un instante que puede expresarse como una fecha del calendario y una hora del día.
Sintaxis:
Rango de valores admitido: [1970-01-01 00:00:00, 2106-02-07 06:28:15].
Resolución: 1 segundo.
El tipo de dato Date es más rápido que DateTime en la mayoría de los casos.
El tipo Date requiere 2 bytes de almacenamiento, mientras que DateTime requiere 4. Sin embargo, durante la compresión, la diferencia de tamaño entre Date y DateTime se vuelve más significativa. Esto se debe a que los minutos y segundos de DateTime son menos compresibles. Filtrar y agregar por Date en lugar de DateTime también es más rápido.
El instante temporal se guarda como un Unix timestamp, independientemente de la zona horaria o del horario de verano. La zona horaria afecta a cómo se muestran en formato de texto los valores de tipo DateTime y a cómo se interpretan los valores especificados como cadenas ('2020-01-01 05:00:01').
En las tablas se almacena un Unix timestamp independiente de la zona horaria, y la zona horaria se utiliza para convertirlo a formato de texto o viceversa durante la importación/exportación de datos, o para realizar cálculos de calendario sobre los valores (por ejemplo, las funciones toDate, toHour, etc.). La zona horaria no se almacena en las filas de la tabla (ni en el conjunto de resultados), sino en los metadatos de la columna.
Puede encontrar una lista de las zonas horarias compatibles en la IANA Time Zone Database, y también puede consultarla con SELECT * FROM system.time_zones. La lista también está disponible en Wikipedia.
Puede establecer explícitamente una zona horaria para las columnas de tipo DateTime al crear una tabla. Ejemplo: DateTime('UTC'). Si no se establece la zona horaria, ClickHouse usa el valor del parámetro timezone en la configuración del servidor o en la configuración del sistema operativo en el momento en que se inicia el servidor de ClickHouse.
clickhouse-client aplica de forma predeterminada la zona horaria del servidor si no se establece explícitamente una zona horaria al inicializar el tipo de dato. Para usar la zona horaria del cliente, ejecute clickhouse-client con el parámetro --use_client_time_zone.
ClickHouse muestra los valores según el valor de la configuración date_time_output_format. De forma predeterminada, utiliza el formato de texto YYYY-MM-DD hh:mm:ss. Además, puede cambiar la salida con la función formatDateTime.
Al insertar datos en ClickHouse, puede usar diferentes formatos de cadenas de fecha y hora, según el valor de la configuración date_time_input_format.
1. Crear una tabla con una columna de tipo DateTime e insertar datos en ella:
CREATE TABLE dt
(
`timestamp` DateTime('Asia/Istanbul'),
`event_id` UInt8
)
ENGINE = TinyLog;
-- Parsear DateTime
-- - desde una cadena de texto,
-- - desde un entero interpretado como número de segundos desde 1970-01-01.
INSERT INTO dt VALUES ('2019-01-01 00:00:00', 1), (1546300800, 2);
SELECT * FROM dt;
┌───────────timestamp─┬─event_id─┐
│ 2019-01-01 00:00:00 │ 1 │
│ 2019-01-01 03:00:00 │ 2 │
└─────────────────────┴──────────┘
- Al insertar un valor datetime como entero, se interpreta como Unix Timestamp (UTC).
1546300800 representa '2019-01-01 00:00:00' UTC. Sin embargo, como la columna timestamp tiene especificada la zona horaria Asia/Istanbul (UTC+3), al mostrarse como cadena el valor aparecerá como '2019-01-01 03:00:00'
- Al insertar un valor de cadena como datetime, se interpreta según la zona horaria de la columna.
'2019-01-01 00:00:00' se interpretará en la zona horaria Asia/Istanbul y se guardará como 1546290000.
2. Filtrado por valores DateTime
SELECT * FROM dt WHERE timestamp = toDateTime('2019-01-01 00:00:00', 'Asia/Istanbul')
┌───────────timestamp─┬─event_id─┐
│ 2019-01-01 00:00:00 │ 1 │
└─────────────────────┴──────────┘
DateTime se pueden filtrar mediante un valor de texto en el predicado WHERE. Este se convertirá automáticamente a DateTime:
SELECT * FROM dt WHERE timestamp = '2019-01-01 00:00:00'
┌───────────timestamp─┬─event_id─┐
│ 2019-01-01 00:00:00 │ 1 │
└─────────────────────┴──────────┘
DateTime:
SELECT toDateTime(now(), 'Asia/Istanbul') AS column, toTypeName(column) AS x
┌──────────────column─┬─x─────────────────────────┐
│ 2019-10-16 04:12:04 │ DateTime('Asia/Istanbul') │
└─────────────────────┴───────────────────────────┘
SELECT
toDateTime(timestamp, 'Europe/London') AS lon_time,
toDateTime(timestamp, 'Asia/Istanbul') AS istanbul_time
FROM dt
┌───────────lon_time──┬───────istanbul_time─┐
│ 2019-01-01 00:00:00 │ 2019-01-01 03:00:00 │
│ 2018-12-31 21:00:00 │ 2019-01-01 00:00:00 │
└─────────────────────┴─────────────────────┘
Limitaciones en la compatibilidad con zonas horarias
Gestión del horario de verano (DST)
date_time_output_format está configurado como simple.- Los relojes se atrasan (“Fall Back”), lo que provoca un solapamiento de una hora.
- Los relojes se adelantan (“Spring Forward”), lo que provoca un hueco de una hora.
De forma predeterminada, ClickHouse siempre elige la primera ocurrencia de una hora solapada y puede interpretar horas inexistentes durante los adelantos del reloj.
Por ejemplo, considere la siguiente transición del horario de verano (DST) al horario estándar.
- El 29 de octubre de 2023, a las 02:00:00, los relojes se atrasan hasta la 01:00:00 (BST → GMT).
- La hora 01:00:00 – 01:59:59 aparece dos veces (una vez en BST y otra en GMT)
- ClickHouse siempre elige la primera ocurrencia (BST), lo que provoca resultados inesperados al sumar intervalos de tiempo.
SELECT '2023-10-29 01:30:00'::DateTime('Europe/London') AS time, time + toIntervalHour(1) AS one_hour_later
┌────────────────time─┬──────one_hour_later─┐
│ 2023-10-29 01:30:00 │ 2023-10-29 01:30:00 │
└─────────────────────┴─────────────────────┘
- El 26 de marzo de 2023, a las
00:59:59, los relojes se adelantan a las 02:00:00 (GMT → BST).
- La hora
01:00:00 – 01:59:59 no existe.
SELECT '2023-03-26 01:30:00'::DateTime('Europe/London') AS time, time + toIntervalHour(1) AS one_hour_later
┌────────────────time─┬──────one_hour_later─┐
│ 2023-03-26 00:30:00 │ 2023-03-26 02:30:00 │
└─────────────────────┴─────────────────────┘
2023-03-26 01:30:00 hasta 2023-03-26 00:30:00.
Última modificación el 10 de junio de 2026
