> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 달력 날짜와 하루 중 시각으로 표현할 수 있는 시점을 초 미만 정밀도의 타임스탬프로 저장하는 ClickHouse의 DateTime64 데이터 타입에 대한 문서

# DateTime64

달력 날짜와 하루 중 시각으로 표현할 수 있는 특정 시점을 정의된 초 미만 정밀도로 저장할 수 있습니다.

틱 크기(정밀도): 10<sup>-정밀도</sup>초입니다. 유효 범위: \[ 0 : 9 ].
일반적으로 3(밀리초), 6(마이크로초), 9(나노초)를 사용합니다.

기본값: 3(밀리초)입니다.

**구문:**

```sql theme={null}
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](/ko/reference/data-types/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`까지입니다.

<div id="examples">
  ## 예시
</div>

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

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

```sql theme={null}
-- 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;
```

```text theme={null}
┌───────────────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`으로 저장됩니다.

2. `DateTime64` 값 필터링

```sql theme={null}
SELECT * FROM dt64 WHERE timestamp = toDateTime64('2019-01-01 00:00:00', 3, 'Asia/Istanbul');
```

```text theme={null}
┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 00:00:00.000 │        3 │
└─────────────────────────┴──────────┘
```

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

```sql theme={null}
SELECT * FROM dt64 WHERE timestamp = toDateTime64(1546300800.123, 3);
```

```text theme={null}
┌───────────────timestamp─┬─event_id─┐
│ 2019-01-01 03:00:00.123 │        1 │
│ 2019-01-01 03:00:00.123 │        2 │
└─────────────────────────┴──────────┘
```

숫자를 삽입할 때와 마찬가지로 `toDateTime64` 함수는 숫자 인수를 초 단위로 처리하므로, 초 미만의 정밀도는
소수점 이하에 지정해야 합니다.

3. `DateTime64` 타입 값의 시간대 가져오기:

```sql theme={null}
SELECT toDateTime64(now(), 3, 'Asia/Istanbul') AS column, toTypeName(column) AS x;
```

```text theme={null}
┌──────────────────column─┬─x──────────────────────────────┐
│ 2023-06-05 00:09:52.000 │ DateTime64(3, 'Asia/Istanbul') │
└─────────────────────────┴────────────────────────────────┘
```

4. 시간대 변환

```sql theme={null}
SELECT
toDateTime64(timestamp, 3, 'Europe/London') AS lon_time,
toDateTime64(timestamp, 3, 'Asia/Istanbul') AS istanbul_time
FROM dt64;
```

```text theme={null}
┌────────────────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 │
└─────────────────────────┴─────────────────────────┘
```

**관련 항목**

* [타입 변환 함수](/ko/reference/functions/regular-functions/type-conversion-functions)
* [날짜 및 시간을 다루는 함수](/ko/reference/functions/regular-functions/date-time-functions)
* [`date_time_input_format` 설정](/ko/reference/settings/formats/date-time#date_time_input_format)
* [`date_time_output_format` 설정](/ko/reference/settings/formats/date-time#date_time_output_format)
* [`timezone` 서버 구성 매개변수](/ko/reference/settings/server-settings/settings/other#timezone)
* [`session_timezone` 설정](/ko/reference/settings/session-settings/other#session_timezone)
* [날짜 및 시간을 다루는 연산자](/ko/reference/operators/index#operators-for-working-with-dates-and-times)
* [`Date` 데이터 타입](/ko/reference/data-types/date)
* [`DateTime` 데이터 타입](/ko/reference/data-types/datetime)