date time 포맷 설정
date time 포맷 설정 (date_time format settings)
이 페이지는 날짜와 시간의 텍스트 표현 방식과 관련된 자동 생성 설정을 다루는 문서예요. DateTime64 값의 출력 정밀도, 날짜·시간 입력/출력 포맷 파서, 오버플로 동작을 설정하는 항목입니다.
출처: 문서
본문
이 설정들은 source에서 자동 생성됩니다.
date_time_64_output_format_cut_trailing_zeros_align_to_groups_of_thousands
DateTime64 값의 뒤쪽 0을 동적으로 제거하고, 모든 유효 숫자를 유지하는 다음 3의 배수([0, 3, 6, 9])로 출력 정밀도를 반올림해요. 모두 0인 분수는 버려집니다.
date_time_input_format
날짜와 시간의 텍스트 표현을 위한 파서를 선택할 수 있게 해줘요. 이 설정은 날짜 및 시간 함수에는 적용되지 않습니다. 가능한 값:
- 'best_effort' — 확장 파싱을 활성화해요. ClickHouse는 기본 YYYY-MM-DD HH:MM:SS 형식과 모든 ISO 8601 날짜·시간 형식을 파싱할 수 있어요. 예: '2018-06-08T01:02:03.000Z'.
- 'best_effort_us' — best_effort와 유사해요(차이점은 parseDateTimeBestEffortUS 참고).
- 'basic' — 기본 파서를 사용해요. ClickHouse는 기본 YYYY-MM-DD HH:MM:SS 또는 YYYY-MM-DD 형식만 파싱할 수 있어요. 예: 2019-08-20 10:18:56 또는 2019-08-20.
참고:
- DateTime 데이터 타입.
- 날짜와 시간을 다루는 함수.
date_time_output_format
날짜와 시간의 텍스트 표현에서 서로 다른 출력 형식을 선택할 수 있게 해줘요. 가능한 값:
- simple — 단순 출력 형식이에요. ClickHouse는 날짜와 시간을 YYYY-MM-DD hh:mm:ss 형식으로 출력해요. 예: 2019-08-20 10:18:56. 계산은 데이터 타입의 시간대(있는 경우) 또는 서버 시간대에 따라 수행돼요.
- iso — ISO 출력 형식이에요. ClickHouse는 날짜와 시간을 ISO 8601 YYYY-MM-DDThh:mm:ssZ 형식으로 출력해요. 예: 2019-08-20T10:18:56Z. 출력은 UTC라는 점에 유의하세요(Z는 UTC를 의미).
- unix_timestamp — Unix 타임스탬프 출력 형식이에요. ClickHouse는 날짜와 시간을 Unix 타임스탬프 형식으로 출력해요. 예: 1566285536.
참고:
- DateTime 데이터 타입.
- 날짜와 시간을 다루는 함수.
date_time_overflow_behavior
Date, Date32, DateTime, DateTime64 또는 정수가 Date, Date32, DateTime, DateTime64로 변환될 때 그 값을 결과 타입으로 표현할 수 없는 경우의 동작을 정의해요. 입력 포맷을 포함해 텍스트에서 Date 또는 DateTime을 파싱할 때도 적용됩니다.
가능한 값:
- ignore — 오버플로를 조용히 무시해요. 결과는 정의되지 않습니다.
- throw — 오버플로가 발생하면 예외를 던져요.
- saturate — 결과를 포화시켜요. 값이 대상 타입이 표현할 수 있는 최솟값보다 작으면 결과는 표현 가능한 최솟값이 되고, 값이 대상 타입이 표현할 수 있는 최댓값보다 크면 결과는 표현 가능한 최댓값이 됩니다.
기본값: ignore.