DateTime64 - ClickHouse Documentation

달력 날짜와 하루 중 시각으로 표현할 수 있는 특정 시점을 정의된 초 미만 정밀도로 저장할 수 있습니다. 틱 크기(정밀도): 10^-정밀도초입니다. 유효 범위: [ 0 : 9 ]. 일반적으로 3(밀리초), 6(마이크로초), 9(나노초)를 사용합니다. 구문:

DateTime64(precision, [timezone])

내부적으로는 epoch 시작 시점(1970-01-01 00:00:00 UTC) 이후의 ‘tick’ 수를 Int64로 저장합니다. tick 해상도는 정밀도 매개변수로 결정됩니다. 또한 DateTime64 타입은 컬럼 전체에 공통으로 적용되는 시간대(time zone)를 저장할 수 있으며, 이는 DateTime64 타입 값이 텍스트 포맷으로 표시되는 방식과 문자열로 지정된 값이 파싱되는 방식(‘2020-01-01 05:00:01.000’)에 영향을 줍니다. 시간대는 테이블의 행(또는 결과 집합)에 저장되지 않고 컬럼 메타데이터에 저장됩니다. 자세한 내용은 DateTime을 참조하십시오. 지원되는 값 범위: [1900-01-01 00:00:00, 2299-12-31 23:59:59.999999999] 소수점 아래 자릿수는 정밀도 매개변수에 따라 달라집니다. 참고: 최댓값의 정밀도는 8입니다. 최대 정밀도인 9자리(나노초)를 사용하는 경우, UTC에서 지원되는 최댓값은 2262-04-11 23:47:16입니다.

예시

DateTime64 타입 컬럼이 있는 테이블을 생성하고 데이터를 삽입합니다:

CREATE TABLE dt64
(
    `timestamp` DateTime64(3, 'Asia/Istanbul'),
    `event_id` UInt8
)
ENGINE = MergeTree;

-- DateTime 파싱
-- - 1970-01-01 이후 밀리초 수로 해석되는 정수 (precision 3이므로),
-- - 소수점 앞부분은 초 단위 Unix 타임스탬프, 소수점 뒷부분은 precision에 따라 처리되는 소수,
-- - 문자열.

INSERT INTO dt64
VALUES
(1546300800123, 1),
(1546300800.123, 2),
('2019-01-01 00:00:00', 3);

SELECT * FROM dt64;

┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 03:00:00.123 │        1 │
│ 2019-01-01 03:00:00.123 │        2 │
│ 2019-01-01 00:00:00.000 │        3 │
└─────────────────────────┴──────────┘

datetime를 정수로 삽입하면, 적절한 scale이 적용된 Unix timestamp(UTC)로 처리됩니다. 1546300800000은 (정밀도가 3인 경우) UTC 기준 '2019-01-01 00:00:00'을 나타냅니다. 하지만 timestamp 컬럼에는 Asia/Istanbul (UTC+3) 시간대가 지정되어 있으므로, 문자열로 출력할 때 값은 '2019-01-01 03:00:00'으로 표시됩니다. datetime를 Decimal로 삽입하는 경우에도 정수와 비슷하게 처리되지만, decimal point 앞의 값은 초 단위까지 포함한 Unix timestamp로 처리되고, decimal point 뒤의 값은 정밀도로 처리됩니다.
문자열 값을 datetime로 삽입하면 컬럼의 시간대를 기준으로 처리됩니다. '2019-01-01 00:00:00'은 Asia/Istanbul 시간대로 간주되어 1546290000000으로 저장됩니다.

DateTime64 값 필터링

SELECT * FROM dt64 WHERE timestamp = toDateTime64('2019-01-01 00:00:00', 3, 'Asia/Istanbul');

┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 00:00:00.000 │        3 │
└─────────────────────────┴──────────┘

DateTime과 달리 DateTime64 값은 String에서 자동 변환되지 않습니다.

SELECT * FROM dt64 WHERE timestamp = toDateTime64(1546300800.123, 3);

┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 03:00:00.123 │        1 │
│ 2019-01-01 03:00:00.123 │        2 │
└─────────────────────────┴──────────┘

삽입할 때와는 달리, toDateTime64 함수는 모든 값을 Decimal 형식으로 처리하므로 정밀도는 소수점 아래에 지정해야 합니다.

DateTime64 유형 값의 시간대 가져오기:

SELECT toDateTime64(now(), 3, 'Asia/Istanbul') AS column, toTypeName(column) AS x;

┌──────────────────column─┬─x──────────────────────────────┐
│ 2023-06-05 00:09:52.000 │ DateTime64(3, 'Asia/Istanbul') │
└─────────────────────────┴────────────────────────────────┘

시간대 변환

SELECT
toDateTime64(timestamp, 3, 'Europe/London') AS lon_time,
toDateTime64(timestamp, 3, 'Asia/Istanbul') AS istanbul_time
FROM dt64;

┌────────────────lon_time─┬───────────istanbul_time─┐
│ 2019-01-01 00:00:00.123 │ 2019-01-01 03:00:00.123 │
│ 2019-01-01 00:00:00.123 │ 2019-01-01 03:00:00.123 │
│ 2018-12-31 21:00:00.000 │ 2019-01-01 00:00:00.000 │
└─────────────────────────┴─────────────────────────┘

관련 항목

​예시

예시