본문으로 건너뛰기
최종 수정: 에

INT 타입으로 변환

string에서 변환​

엄격 모드​

원본 타입이 nullable이면 nullable 타입을 반환합니다;

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다;

BNF 정의​

<integer>       ::= <whitespace>* <sign>? <decimal_digit>+ <whitespace>*

<sign>          ::= "+" | "-"

<decimal_digit> ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

<whitespace>    ::= " " | "\t" | "\n" | "\r" | "\f" | "\v"

규칙 설명​

  • 십진수 형식의 숫자만 지원합니다;

  • 숫자 앞에 양수 또는 음수 부호를 붙일 수 있습니다;

  • 문자열 앞뒤에 ' ', '\t', '\n', '\r', '\f', '\v' 등의 공백 문자를 자유롭게 넣을 수 있습니다;

  • 과학적 표기법은 지원하지 않습니다;

  • 그 외 형식은 오류를 반환합니다;

  • 오버플로가 발생하면 오류를 반환합니다.

예제​

문자열int로 변환한 결과설명
"2147483647"2147483647
"-2147483648"-2147483648
" \t\r\n\f\v2147483647 \t\r\n\f\v"2147483647앞뒤에 공백이 있음
" \t\r\n\f\v+2147483647 \t\r\n\f\v"2147483647앞뒤에 공백이 있으며 양수 부호가 있음
" \t\r\n\f\v-2147483648 \t\r\n\f\v"-2147483648앞뒤에 공백이 있으며 음수 부호가 있음
'abc'Error잘못된 형식
'123.456'Error소수 형식은 지원하지 않음
'1.23456e5'Error과학적 표기법은 지원하지 않음
'2147483648'Error오버플로
'-2147483649'Error오버플로

비엄격 모드​

항상 nullable 타입을 반환합니다.

BNF 정의​

<integer_non_strict> ::= <whitespace_char>* <sign>? <number> <whitespace_char>*

<sign>               ::= "+" | "-"

<number>             ::= <decimal_number> | <decimal_number> "." <decimal_number> | <decimal_number> "." | "." <decimal_number>

<decimal_number>     ::= <decimal_digit>+

<decimal_digit>      ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

<whitespace_char>    ::= " " | "\t" | "\n" | "\r" | "\f" | "\v"

규칙 설명​

  • 엄격 모드에서 유효한 모든 형식을 지원합니다;

  • 엄격 모드의 형식 뒤에 소수부가 붙은 형식도 지원하며, 변환 시 소수부를 그대로 버립니다;

  • 과학적 표기법 형식은 NULL로 변환합니다;

  • 그 외 모든 형식은 NULL로 변환합니다;

  • 오버플로가 발생하면 NULL로 변환합니다.

예제​

문자열int로 변환한 결과설명
"2147483647"2147483647
"-2147483648"-2147483648
" \t\r\n\f\v2147483647 \t\r\n\f\v"2147483647앞뒤에 공백이 있음
" \t\r\n\f\v+2147483647 \t\r\n\f\v"2147483647앞뒤에 공백이 있으며 양수 부호가 있음
" \t\r\n\f\v-2147483648 \t\r\n\f\v"-2147483648앞뒤에 공백이 있으며 음수 부호가 있음
'123.456'123
'1.23456e5'NULL과학적 표기법
'abc'NULL잘못된 형식
'2147483648'NULL오버플로
'-2147483649'NULL오버플로

bool에서 변환​

true는 1로, false는 0으로 변환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

정수에서 정수로 변환​

모든 정수 타입 간 변환을 지원합니다.

엄격 모드​

오버플로가 발생하면 오류를 반환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

예제​

Bigintint설명
21474836472147483647
2147483648Error오버플로
-2147483649Error오버플로

비엄격 모드​

동작 변경

버전 4.0부터 오버플로 발생 시 정의되지 않은 값 대신 NULL을 반환합니다.

오버플로가 발생하면 NULL을 반환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable인 경우:

  • 오버플로가 발생할 수 있으면(예: cast bigint as int) nullable 타입을 반환합니다;

  • 그 외에는 non-nullable 타입을 반환합니다(예: cast int as bigint).

예제​

Bigintint설명
21474836472147483647
2147483648NULL오버플로
-2147483649NULL오버플로

date에서 변환​

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

규칙 설명​

동작 변경

버전 4.0부터 date를 tinyint 및 smallint로 변환하는 기능을 더 이상 지원하지 않습니다.

  • 오버플로가 반드시 발생하므로 tinyint 및 smallint로의 변환은 지원하지 않습니다.

  • int, bigint 및 largeint로의 변환을 지원합니다. 날짜의 연도, 월, 일 숫자를 순서대로 이어 붙여 정수를 만듭니다. 월과 일은 두 자리로 표현하며, 값이 10보다 작으면 앞에 0을 붙입니다.

예제​

dateint
2025-03-1420250314

datetime에서 변환​

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

규칙 설명​

동작 변경

버전 4.0부터 datetime을 tinyint, smallint 및 int로 변환하는 기능을 더 이상 지원하지 않습니다.

  • 오버플로가 반드시 발생하므로 tinyint, smallint, int로의 변환은 지원하지 않습니다;

  • bigint 및 largeint로의 변환을 지원합니다. datetime의 마이크로초 부분을 버린 다음 연도, 월, 일, 시, 분, 초를 순서대로 이어 붙여 정수를 만듭니다. 월, 일, 시, 분, 초는 두 자리로 표현하며, 값이 10보다 작으면 앞에 0을 붙입니다.

예제​

datetimeint
2025-03-14 17:00:01.12345620250314170001
9999-12-31 23:59:59.99999999991231235959

TIMESTAMP_NS에서 변환​

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

규칙 설명​

  • 오버플로가 반드시 발생하므로 tinyint, smallint 또는 int로의 변환은 지원하지 않습니다.

  • bigint 및 largeint로의 변환을 지원합니다. TIMESTAMP_NS의 나노초 부분을 버린 다음 연도, 월, 일, 시, 분, 초를 순서대로 이어 붙여 정수를 만듭니다. 월, 일, 시, 분, 초는 두 자리로 표현하며, 값이 10보다 작으면 앞에 0을 붙입니다.

예제​

입력 TIMESTAMP_NS대상 타입결과
1677-09-21 00:12:43.145224192BIGINT16770921001243
1969-12-31 23:59:59.999999999BIGINT19691231235959
2024-02-29 12:34:56.123456789LARGEINT20240229123456
2262-04-11 23:47:16.854775807LARGEINT22620411234716

float/double에서 변환​

반올림을 지원하지 않습니다.

엄격 모드​

규칙 설명​

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

  • 오버플로가 발생하면 오류를 반환합니다;

  • Infinity 및 NaN 값은 오류를 반환합니다.

예제​

float/doubleint로 변환설명
1.51소수부 버림
1.79769E308Error오버플로
InfinityError
NaNError

비엄격 모드​

항상 nullable 타입을 반환합니다.

규칙 설명​

동작 변경

버전 4.0부터 오버플로 발생 시 정의되지 않은 값 대신 NULL을 반환합니다.

  • 오버플로가 발생하면 NULL로 변환합니다;

  • Infinity는 NULL로 변환합니다;

  • NaN은 NULL로 변환합니다.

예제​

float/doubleint로 변환설명
1.51소수부 버림
1.79769E308NULL오버플로
InfinityNULL
-InfinityNULL
NaNNULL

decimal에서 변환​

반올림을 지원하지 않습니다.

엄격 모드​

오버플로가 발생하면 오류를 반환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

예제​

Decimal(18, 6)int설명
1.6543211소수부 버림
12345678901.123Error오버플로

비엄격 모드​

오버플로가 발생하면 NULL로 변환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable인 경우:

  • 오버플로가 발생할 수 있으면(예: cast decimal(18, 0) as int) nullable 타입을 반환합니다;

  • 그 외에는 non-nullable 타입을 반환합니다(예: cast decimal(9, 0) as bigint).

예제​

Decimal(18, 6)int설명
1.6543211소수부 버림
12345678901.123NULL오버플로

time에서 변환​

마이크로초로 변환합니다.

엄격 모드​

오버플로가 발생하면 오류를 반환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable이면 non-nullable 타입을 반환합니다.

예제​

Timeint설명
00:00:011000000
838:59:58Error오버플로

비엄격 모드​

동작 변경

버전 4.0부터 오버플로 발생 시 정의되지 않은 값 대신 NULL을 반환합니다.

오버플로가 발생하면 NULL로 변환합니다.

원본 타입이 nullable이면 nullable 타입을 반환합니다.

원본 타입이 non-nullable인 경우:

  • 오버플로가 발생할 수 있으면(예: cast time as tinyint) nullable 타입을 반환합니다;

  • 그 외에는 non-nullable 타입을 반환합니다(예: cast time as bigint).

예제​

Timeint설명
00:00:011000000
838:59:58NULL오버플로

기타 타입​

지원하지 않습니다

Report issue