DateTime64

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

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을 참조하십시오. 지원되는 값 범위: [0000-01-01 00:00:00, 9999-12-31 23:59:59.999999999] 소수점 아래 자릿수는 정밀도 매개변수에 따라 달라집니다. 참고: 위의 전체 범위는 정밀도가 7 이하일 때 사용할 수 있습니다. tick은 Int64에 저장되므로, 더 높은 정밀도에서는 더 좁은 범위만 지원합니다. 정밀도 8에서는 최댓값이 대략 4892-10-07이며, 최대 정밀도인 9자리(나노초)에서는 UTC 기준 지원 범위가 1677-09-21 00:12:44부터 2262-04-11 23:47:16까지입니다.

예시

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

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

-- Parse DateTime64
-- - from an integer interpreted as the number of seconds since 1970-01-01 (like DateTime),
-- - from a decimal interpreted as the number of seconds, the fractional part giving sub-second precision,
-- - from a string.

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

SELECT * FROM dt64;

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

datetime를 숫자로 삽입하면 DateTime과 마찬가지로 초 단위 Unix Timestamp(UTC)로 처리됩니다. 1546300800은 UTC 기준 '2019-01-01 00:00:00'을 나타냅니다. 하지만 timestamp 컬럼에는 Asia/Istanbul (UTC+3) 시간대가 지정되어 있으므로, 문자열로 출력할 때 값은 '2019-01-01 03:00:00'으로 표시됩니다. 소수 부분이 있는 숫자를 삽입하는 경우에도 동일하게 처리됩니다. 소수점 앞부분은 초 단위 Unix Timestamp이고, 소수점 뒷부분은 컬럼의 정밀도에 따른 초 미만 정밀도를 제공합니다. (버전 26.8 이전에는 JSON 및 Values/Quoted 입력 경로에서 따옴표로 묶지 않은 정수(후자는 Quoted 이스케이프 규칙으로 필드를 파싱하는 모든 포맷, 즉 Values, MySQLDump, 그리고 Quoted 필드 이스케이프를 구성한 Template/CustomSeparated/Regexp를 포함함)가 컬럼 정밀도에 맞는 원시 내부 값으로 해석되었으므로, 정밀도 3에서 1546300800000은 '2019-01-01 00:00:00'을 의미했습니다. 이러한 경로에서 이전 동작을 복원하려면 input_format_read_datetime_number_as_raw_value = 1(또는 SET compatibility = '26.7')을 설정하십시오. 이 설정은 JSONExtract 함수와 JSON 데이터 타입에도 영향을 줍니다. compatibility 설정은 따옴표로 묶지 않은 정수에만 적용됩니다. Values 포맷에서 legacy 스트리밍 파서가 거부하는 소수는 SQL 표현식 평가로 대체 처리되어 초 단위로 읽히며, 이는 26.8 이전 버전과 동일합니다. JSONExtract 및 JSON 데이터 타입에서 소수 값은 Float64를 통해 파싱되므로, Float64가 보존할 수 있는 자릿수보다 많은 타임스탬프는 원본 텍스트를 정확히 파싱하는 행 입력 포맷과 달리 인접한 값으로 반올림될 수 있습니다. 탭으로 구분된 형식, CSV 및 기타 이스케이프된 텍스트 입력 포맷은 이 설정의 적용을 받지 않으며, 따옴표로 묶지 않은 숫자에 대한 기존 해석을 유지합니다. 큰 값은 틱으로 읽힙니다.)
문자열 값을 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 함수는 숫자 인수를 초 단위로 처리하므로, 초 미만의 정밀도는 소수점 이하에 지정해야 합니다.

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 │
└─────────────────────────┴─────────────────────────┘

관련 항목

SQL 참고

데이터 타입

엔진

함수

포맷

인터페이스

설정

시스템 테이블

데이터 레이크

예시

​예시

예시