> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.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(나노초)를 사용합니다.

**구문:**

```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)을 참조하십시오.

지원되는 값 범위: \[1900-01-01 00:00:00, 2299-12-31 23:59:59.999999999]

소수점 아래 자릿수는 정밀도 매개변수에 따라 달라집니다.

참고: 최댓값의 정밀도는 8입니다. 최대 정밀도인 9자리(나노초)를 사용하는 경우, UTC에서 지원되는 최댓값은 `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}
-- 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;
```

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

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` 함수는 모든 값을 Decimal 형식으로 처리하므로 정밀도는
소수점 아래에 지정해야 합니다.

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_input_format)
* [`date_time_output_format` 설정](/ko/reference/settings/formats#date_time_output_format)
* [`timezone` 서버 구성 매개변수](/ko/reference/settings/server-settings/settings#timezone)
* [`session_timezone` 설정](/ko/reference/settings/session-settings#session_timezone)
* [날짜 및 시간을 다루는 연산자](/ko/reference/operators#operators-for-working-with-dates-and-times)
* [`Date` 데이터 타입](/ko/reference/data-types/date)
* [`DateTime` 데이터 타입](/ko/reference/data-types/datetime)