Time64 - ClickHouse Documentation

데이터 타입 Time64는 소수 초를 포함한 시각(time-of-day)을 나타냅니다. 달력 날짜 구성 요소(일, 월, 연도)는 포함하지 않습니다. precision 매개변수는 소수 자릿수를 정의하며, 이에 따라 틱 크기도 결정됩니다. 틱 크기(precision): 10^-precision초. 유효 범위: 0..9입니다. 일반적으로 3(밀리초), 6(마이크로초), 9(나노초)를 사용합니다. 구문:

Time64(precision)

내부적으로 Time64는 소수 초를 나타내는 부호 있는 64비트 Decimal(Decimal64) 값을 저장합니다. 틱 해상도는 precision 매개변수로 결정됩니다. Time64는 시간대를 지원하지 않습니다. Time64에 시간대를 지정하면 오류가 발생합니다. DateTime64와 달리 Time64는 날짜 구성 요소를 저장하지 않습니다. 관련 항목 Time. 텍스트 표현 범위: precision = 3일 때 [-999:59:59.000, 999:59:59.999]입니다. 일반적으로 최솟값은 -999:59:59, 최댓값은 999:59:59이며, 소수 자릿수는 최대 precision까지 지원됩니다 (precision = 9이면 최솟값은 -999:59:59.999999999입니다).

구현 세부 정보

표현 방식. 소수부 자릿수가 precision인 초 단위 분수를 저장하는 부호 있는 Decimal64 값입니다. 정규화. 문자열을 Time64로 구문 분석할 때 시간 구성 요소는 정규화되며 유효성 검사는 수행되지 않습니다. 예를 들어 25:70:70은 26:11:10으로 해석됩니다. 음수 값. 앞의 마이너스 기호가 지원되며 그대로 유지됩니다. 음수 값은 일반적으로 Time64 값에 대한 산술 연산으로 인해 발생합니다. Time64에서는 텍스트 입력(예: '-01:02:03.123')과 숫자 입력(예: -3723.123) 모두에서 음수 입력이 그대로 유지됩니다. 포화. 구성 요소로 변환하거나 텍스트로 직렬화할 때 하루 중 시간(time-of-day) 구성 요소는 [-999:59:59.xxx, 999:59:59.xxx] 범위로 제한됩니다. 저장된 숫자 값은 이 범위를 초과할 수 있지만, 구성 요소 추출(시, 분, 초)과 텍스트 표현에는 포화된 값이 사용됩니다. 시간대. Time64는 시간대를 지원하지 않습니다. Time64 유형이나 값을 생성할 때 시간대를 지정하면 오류가 발생합니다. 마찬가지로 Time64 컬럼에 시간대를 적용하거나 변경하려는 시도도 지원되지 않으며 오류가 발생합니다.

예시

Time64 유형의 컬럼이 있는 테이블을 생성하고 데이터를 삽입하는 예시:

CREATE TABLE tab64
(
    `event_id` UInt8,
    `time` Time64(3)
)
ENGINE = TinyLog;

-- Time64 파싱
-- - 문자열로부터,
-- - 00:00:00 이후의 초(소수 부분은 정밀도에 따름)로부터.
INSERT INTO tab64 VALUES (1, '14:30:25'), (2, 52225.123), (3, '14:30:25');

SELECT * FROM tab64 ORDER BY event_id;

   ┌─event_id─┬────────time─┐
1. │        1 │ 14:30:25.000 │
2. │        2 │ 14:30:25.123 │
3. │        3 │ 14:30:25.000 │
   └──────────┴──────────────┘

Time64 값에 대한 필터링

SELECT * FROM tab64 WHERE time = toTime64('14:30:25', 3);

   ┌─event_id─┬────────time─┐
1. │        1 │ 14:30:25.000 │
2. │        3 │ 14:30:25.000 │
   └──────────┴──────────────┘

SELECT * FROM tab64 WHERE time = toTime64(52225.123, 3);

   ┌─event_id─┬────────time─┐
1. │        2 │ 14:30:25.123 │
   └──────────┴──────────────┘

참고: toTime64는 지정된 정밀도에 따라 숫자 리터럴을 소수 부분이 있는 초 단위 값으로 해석하므로, 의도한 소수 자릿수를 명시적으로 지정하십시오.

결과 유형 확인:

SELECT CAST('14:30:25.250' AS Time64(3)) AS column, toTypeName(column) AS type;

   ┌────────column─┬─type──────┐
1. │ 14:30:25.250 │ Time64(3) │
   └───────────────┴───────────┘

Date와의 덧셈

Time64 값은 Date 또는 Date32 값에 더할 수 있으며, 그 결과 Time64와 동일한 scale을 가진 DateTime64가 생성됩니다:

SET use_legacy_to_time = 0;
SELECT toDate('2024-07-15') + toTime64('14:30:25.123456', 6) AS dt, toTypeName(dt);

   ┌─────────────────────────dt─┬─toTypeName(dt)─┐
1. │ 2024-07-15 14:30:25.123456 │ DateTime64(6)  │
   └────────────────────────────┴────────────────┘

지원되는 모든 조합과 결과 타입에 대한 자세한 내용은 날짜 및 시간 덧셈을 참조하십시오. 관련 항목

​구현 세부 정보

​예시

​Date와의 덧셈

구현 세부 정보

예시

Date와의 덧셈