TO_CHAR

TO_CHAR (문자열 변환)

값을 문자열(VARCHAR) 값으로 변환해요.

출처: Snowflake SQL Reference - TO_CHAR

본문

구문

TO_CHAR 함수는 오버로드된 형태로 제공되며, 값의 데이터 타입에 따라 다양한 구문을 지원해요.

숫자 값을 문자열로:

TO_CHAR( <numeric_expr> [ , '<numeric_output_format>' ] )

날짜/시간 값을 문자열로:

TO_CHAR( <date_or_time_expr> [ , '<format>' ] )

VARIANT 값을 문자열로:

TO_CHAR( <variant_expr> )

BINARY 값을 문자열로:

TO_CHAR( <binary_expr> [ , '<format>' ] )

인자

numeric_expr

문자열로 변환할 숫자 표현식이에요.

numeric_output_format

출력에 사용할 숫자 형식 문자열이에요. 생략하면 세션 매개변수 NUMERIC_OUTPUT_FORMAT(기본값은 '')이 사용돼요.

date_or_time_expr

문자열로 변환할 날짜 또는 시간 표현식이에요.

format

날짜/시간 출력 형식 문자열이에요. 생략하면 세션 매개변수 DATE_OUTPUT_FORMAT, TIME_OUTPUT_FORMAT 또는 TIMESTAMP_OUTPUT_FORMAT(데이터 타입에 따라)이 사용돼요.

variant_expr

문자열로 변환할 VARIANT 표현식이에요. VARIANT 값이 문자열이면 그 문자열이 반환되고, 그 외의 경우에는 (숫자 형식 없는) TO_CHAR 결과가 반환돼요.

binary_expr

문자열로 변환할 BINARY 표현식이에요.

반환 값

VARCHAR 타입 값을 반환해요.

입력이 NULL이면 NULL을 반환해요.

예시

날짜 값을 기본 형식으로 변환해요:

SELECT TO_CHAR(TO_DATE('2024-04-15', 'YYYY-MM-DD')) AS string_value;

+--------------+
| STRING_VALUE |
|--------------|
| 2024-04-15   |
+--------------+

숫자 값을 지정한 형식으로 변환해요:

SELECT TO_CHAR(1234.56, '9999.99') AS string_value;

+--------------+
| STRING_VALUE |
|--------------|
| 1234.56      |
+--------------+

더 알아보기

• Conversion functions