변환 함수

이 함수 집합은 Snowflake 데이터 타입의 식을 다른 데이터 타입으로 변환하는 데 사용할 수 있습니다.

이 항목의 내용:

함수 목록

하위 카테고리

함수

참고

임의의 데이터 타입

CAST , ::

TRY_CAST

CAST의 오류 처리 버전입니다.

텍스트/문자/이진 데이터 타입

TO_CHAR , TO_VARCHAR

TO_BINARY

TRY_TO_BINARY

TO_BINARY에 대한 오류 처리 버전입니다.

숫자 데이터 타입

TO_DECIMAL , TO_NUMBER , TO_NUMERIC

TO_DOUBLE

TRY_TO_DECIMAL, TRY_TO_NUMBER, TRY_TO_NUMERIC

TO_DECIMAL, TO_NUMBER 등의 오류 처리 버전입니다.

TRY_TO_DOUBLE

TO_DOUBLE의 오류 처리 버전입니다.

부울 데이터 타입

TO_BOOLEAN

TRY_TO_BOOLEAN

TO_BOOLEAN의 오류 처리 버전입니다.

날짜 및 시간 데이터 타입

TO_DATE , DATE

TO_TIME , TIME

TO_TIMESTAMP / TO_TIMESTAMP_*

TRY_TO_DATE

TO_DATE의 오류 처리 버전입니다.

TRY_TO_TIME

TO_TIME의 오류 처리 버전입니다.

TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*

TO_TIMESTAMP 등의 오류 처리 버전입니다.

반정형 데이터 타입

TO_ARRAY

TO_OBJECT

TO_VARIANT

지리 공간 데이터 타입

TO_GEOGRAPHY

TRY_TO_GEOGRAPHY

TO_GEOGRAPHY의 오류 처리 버전입니다.

ST_GEOGFROMGEOHASH

ST_GEOGPOINTFROMGEOHASH

ST_GEOGRAPHYFROMWKB

ST_GEOGRAPHYFROMWKT

TO_GEOMETRY

TRY_TO_GEOMETRY

TO_GEOMETRY의 오류 처리 버전입니다.

ST_GEOMETRYFROMWKB

ST_GEOMETRYFROMWKT

오류 처리 변환 함수

TRY_ 접두사가 있는 변환 함수는 각 변환 함수의 특수 버전입니다. 이들 함수는 변환을 수행할 수 없을 때 오류를 발생시키는 대신 NULL 값을 반환합니다.

이들 함수는 문자열 식(즉, VARCHAR 또는 CHAR 데이터 타입)만 입력으로 지원합니다.

중요

이러한 오류 처리 변환 함수는 변환 오류가 비교적 드물게 발생하는 상황에 최적화되어 있습니다.

  • 오류가 없거나 거의 없는 경우, 눈에 띄는 성능상의 영향을 일으키지 않아야 합니다.

  • 변환 실패가 많이 발생하는 경우 이러한 함수를 사용하면 성능이 상당히 저하될 수 있습니다. 또한, VARIANT 형식과 함께 사용할 때 일부 작업은 성능 저하를 일으킬 수 있습니다.

변환 함수의 숫자 형식

TO_DECIMAL , TO_NUMBER , TO_NUMERICTO_DOUBLE 함수는 입력 식이 문자열로 계산되는 경우 입력 문자열의 형식을 지정하는 선택적 매개 변수를 허용합니다. 이 매개 변수가 가질 수 있는 값에 대한 자세한 내용은 SQL 형식 모델 을 참조하십시오.

변환 함수의 날짜 및 시간 형식

다음 함수를 사용해 예상 날짜, 시간 또는 타임스탬프 형식을 지정하여 문자열을 구문 분석하거나 생성할 수 있습니다.

형식을 설명하는 대/소문자를 구분하지 않는 다음 요소를 사용하여 선택적 인자에 형식을 지정합니다.

형식 요소

설명

YYYY

4자리 숫자 연도입니다.

YY

TWO_DIGIT_CENTURY_START 세션 매개 변수로 제어되는 2자리 숫자 연도, 예: 1980 로 설정하면 7980 의 값은 각각 20791980 로 구문 분석됩니다.

MM

2자리 숫자 월(01=1월 등)입니다.

MON

전체 또는 간략한 월 이름입니다.

MMMM

전체 월 이름입니다.

DD

월의 2자리 숫자 일(01~31)입니다.

DY

간략한 요일입니다.

HH24

시간에 대한 2자리 숫자(00~23). AM / PM 을 지정하면 안 됩니다.

HH12

시간에 대한 2자리 숫자(01~12). AM / PM 을 지정할 수 있습니다.

AM , PM

오전(am)/오후(pm). HH12 와만 함께 사용하십시오(HH24 와 함께 사용하지 않음).

MI

분에 대한 2자리 숫자(00~59)입니다.

SS

초에 대한 2자리 숫자(00~59)입니다.

FF[0-9]

0(초) ~ 9(나노초) 정밀도의 소수 자리 초입니다. 예: FF, FF0, FF3, FF9. FF 를 지정하는 것은 FF9 (나노초)와 같습니다.

TZH:TZM , TZHTZM , TZH

타임존의 시 및 분이며, UTC 기준 차이입니다. + / - 를 기호의 접두사로 사용할 수 있습니다.

UUUU

ISO 형식 의 4자리 연도이며, BCE 연도의 경우 음수입니다.

참고

  • 날짜 전용 형식을 사용하는 경우 연결된 시간은 해당 날짜의 자정으로 간주됩니다.

  • 큰따옴표 사이에 있는 형식이나 위 요소 이외의 형식으로 된 항목은 모두 해석되지 않고 구문 분석/형식 지정됩니다.

  • 유효한 범위, 자릿수, 모범 사례에 대한 자세한 내용은 날짜, 시간 및 타임스탬프 형식 사용에 대한 추가 정보 섹션을 참조하십시오.

사용법 노트

큰따옴표 사이에 있는 형식이나 위 요소 이외의 형식으로 된 항목은 모두 해석되지 않고 구문 분석/형식 지정됩니다.

SELECT TO_DATE('3/4/2013', 'dd/mm/yyyy');

-----------------------------------+
 to_date('3/4/2013', 'dd/mm/yyyy') |
-----------------------------------+
 2013-04-03                        |
-----------------------------------+
Copy
SELECT TO_VARCHAR('2013-04-05'::date, 'mon dd, yyyy');

------------------------------------------------+
 to_varchar('2013-04-05'::date, 'mon dd, yyyy') |
------------------------------------------------+
 Apr 05, 2013                                   |
------------------------------------------------+
Copy

변환 함수의 이진 형식

TO_CHAR , TO_VARCHARTO_BINARY 는 문자열을 구문 분석하거나 생성하기 위해 예상되는 형식을 지정하는 선택적 인자를 허용합니다.

형식은 다음 문자열 중 하나일 수 있습니다(대/소문자 구분 안 함).

  • HEX

  • BASE64

  • UTF-8

이러한 형식에 대한 자세한 내용은 Overview of Supported Binary Formats 를 참조하십시오.

이러한 형식을 사용하는 예는 Binary Input and Output 의 예 섹션을 참조하십시오.