PostgreSQL 22008: 날짜/시간 필드 값 범위 초과
날짜 또는 시간이 유효한 범위를 벗어난 필드를 가지고 있었습니다. 예를 들어 30일 달에 13월이나 31일, 일/월 순서가 혼동된 경우입니다.
- SQLSTATE
22008- 이름
datetime_field_overflow- 카테고리
- 데이터 예외
의미
입력값이 날짜나 시간처럼 보였지만, 필드 중 하나가 불가능한 값입니다: 12를 넘는 월, 해당 월에 존재하지 않는 일, 24를 넘는 시. 22008 (datetime_field_overflow)는 표현 가능한 범위를 벗어난 결과도 포함하는데, 예를 들어 timestamp out of range.
값이 다음과 같은 숫자 날짜일 때 13/01/2026, PostgreSQL은 다른 것을 써야 할 수 있다는 힌트를 추가합니다 DateStyle, 13을 월로 읽었기 때문입니다.
일반적인 원인
- 일과 월이 바뀐 기준은 세션의
DateStyle. - 2월 30일처럼 달력에 없는 날짜가 소스 데이터에 있는 경우.
- 지원되는 범위를 벗어난 값을 생성하는 날짜 연산.
해결 방법
-
ISO 8601 날짜를 사용하세요(
YYYY-MM-DD), 이들은 절대 모호하지 않습니다. -
날짜가 일을 앞세운 형식이라면 그렇게 알리거나, 명시적인 형식으로 파싱하세요.
SET DateStyle = 'ISO, DMY'; SELECT '13/01/2026'::date; -- or SELECT to_date('13/01/2026', 'DD/MM/YYYY'); -
변환하기 전에 스테이징 테이블에서 잘못된 행 찾기(PostgreSQL 16 이상).
SELECT raw_date FROM staging WHERE NOT pg_input_is_valid(raw_date, 'date');
안전하게 재현하세요
SELECT '2026-02-30'::date; -- ERROR: date/time field value out of range: "2026-02-30"
관련 오류
22007잘못된 날짜/시간 형식22003숫자 값이 범위를 벗어났습니다242SQL Server: 범위를 벗어난 날짜 변환1292MySQL: 잘못된 값이 잘림ORA-01843Oracle: 유효한 월이 아닙니다
그 밖의 데이터 예외 오류
22021인코딩에 대한 잘못된 바이트 시퀀스220120으로 나눔22023잘못된 매개변수 값22001타입에 비해 값이 너무 깁니다22P02다음 타입에 대한 잘못된 입력 구문
코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 PostgreSQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.