카테고리:

변환 함수 , 날짜 및 시간 함수

TO_TIMESTAMP / TO_TIMESTAMP_*

입력 식을 다음과 같은 해당 타임스탬프로 변환합니다.

  • TO_TIMESTAMP_LTZ (현지 타임존이 있는 타임스탬프)

  • TO_TIMESTAMP_NTZ (타임존이 없는 타임스탬프)

  • TO_TIMESTAMP_TZ (타임존이 있는 타임스탬프)

참고

TO_TIMESTAMP는 TIMESTAMP_TYPE_MAPPING 세션 매개 변수를 기반으로 다른 타임스탬프 함수 중 하나에 매핑됩니다. 매개 변수 기본값은 TIMESTAMP_NTZ이므로, TO_TIMESTAMP는 기본적으로 TO_TIMESTAMP_NTZ에 매핑됩니다.

참고 항목:

TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_* ,

AS_TIMESTAMP_* , IS_TIMESTAMP_* ,

TO_DATE , DATE , TO_TIME , TIME

구문

timestampFunction ( <numeric_expr> [ , <scale> ] ) timestampFunction ( <date_expr> ) timestampFunction ( <timestamp_expr> ) timestampFunction ( <string_expr> [ , <format> ] ) timestampFunction ( '<integer>' ) timestampFunction ( <variant_expr> )
Copy

여기서:

timestampFunction ::= TO_TIMESTAMP | TO_TIMESTAMP_LTZ | TO_TIMESTAMP_NTZ | TO_TIMESTAMP_TZ
Copy

인자

필수:

다음 중 하나:

numeric_expr

Unix epoch(1970-01-01 00:00:00 UTC)가 시작된 이후의 초 단위 수(스케일 = 0 또는 없는 경우) 또는 소수 자리 초(예: 밀리초 또는 나노초)입니다. 정수가 아닌 10진수 식이 입력되면 결과의 스케일이 상속됩니다.

date_expr

타임스탬프로 변환할 날짜입니다.

timestamp_expr

다른 타임스탬프로 변환할 타임스탬프입니다(예: TIMESTAMP_LTZ를 TIMESTAMP_NTZ로 변환).

string_expr

타임스탬프를 추출할 문자열(예: '2019-01-31 01:02:03.004')입니다.

'integer'

정수를 포함하는 문자열로 평가되는 식입니다(예: '15000000'). 문자열의 크기에 따라 초, 밀리초, 마이크로초 또는 나노초로 해석될 수 있습니다. 자세한 내용은 사용법 노트 를 참조하십시오.

variant_expr

VARIANT 형식의 식입니다. VARIANT는 다음 중 하나를 포함해야 합니다.

  • 타임스탬프를 추출할 문자열입니다.

  • 타임스탬프입니다.

  • 초, 밀리초, 마이크로초 또는 나노초 수를 나타내는 정수입니다.

  • 초, 밀리초, 마이크로초 또는 나노초 수를 나타내는 정수가 포함된 문자열입니다.

TO_TIMESTAMP는 DATE 값을 허용하지만, VARIANT 내부의 DATE는 허용하지 않습니다.

선택 사항:

format

형식 지정자(string_expr 에만 해당)입니다. 자세한 내용은 변환 함수의 날짜 및 시간 형식 섹션을 참조하십시오.

기본값은 TIMESTAMP_INPUT_FORMAT 매개 변수의 현재 값입니다(기본값 AUTO).

scale

소수 자릿수 지정자(numeric_expr 에만 해당)입니다. 지정된 경우, 제공된 숫자의 스케일을 정의합니다. 예:

  • 초의 경우, 소수 자릿수 = 0 입니다.

  • 밀리초의 경우, 소수 자릿수 = 3 입니다.

  • 마이크로초의 경우, 소수 자릿수 = 6 입니다.

  • 나노초의 경우, 소수 자릿수 = 9 입니다.

기본값: 0

반환

반환된 값의 데이터 타입은 TIMESTAMP 데이터 타입 중 하나입니다. 기본적으로 데이터 타입은 TIMESTAMP_NTZ 입니다. TIMESTAMP_TYPE_MAPPING 세션 매개 변수를 설정하여 이를 변경할 수 있습니다.

입력이 NULL이면 결과도 NULL입니다.

사용법 노트

  • 이 함수 집합은 특히 다음과 같은 타임스탬프 값을 반환합니다.

    • string_expr 의 경우: 주어진 문자열이 나타내는 타임스탬프입니다. 문자열에 시간 구성 요소가 없는 경우, 자정이 사용됩니다.

    • date_expr 의 경우: 특정 타임스탬프 매핑(NTZ/LTZ/TZ) 의미 체계에 따라 지정된 날짜의 자정을 나타내는 타임스탬프가 사용됩니다.

    • timestamp_expr 의 경우: 소스 타임스탬프와 매핑이 다를 수 있는 타임스탬프입니다.

    • numeric_expr 의 경우: 사용자가 제공한 초 단위 수(또는 소수 자리 초)를 나타내는 타임스탬프입니다. 결과를 작성하는 데 UTC 시간이 항상 사용됩니다.

    • variant_expr 의 경우:

      • VARIANT에 JSON Null 값이 포함된 경우 출력은 NULL입니다.

      • VARIANT에 결과와 같은 종류의 타임스탬프 값이 포함된 경우, 이 값은 있는 그대로 유지됩니다.

      • VARIANT에 다른 종류의 값을 포함된 경우, 변환은 timestamp_expr 에서와 동일한 방식으로 수행됩니다.

      • VARIANT에 문자열이 포함된 경우 문자열 값에서 변환이 수행됩니다(자동 형식 사용).

      • VARIANT에 숫자가 포함된 경우 numeric_expr 의 변환이 수행됩니다.

        참고

        INTEGER 값이 TIMESTAMP_NTZ로 직접 캐스팅되면 정수는 Linux epoch 시작 이후의 초 단위 수로 처리되며, 현지 타임존은 고려되지 않습니다. 그러나 INTEGER 값이 예를 들어, 아래와 같이 VARIANT 값 내부에 저장되는 경우 변환은 간접적이며, 최종 결과가 TIMESTAMP_NTZ이더라도 현지 타임존의 영향을 받습니다.

        SELECT TO_TIMESTAMP(31000000); SELECT TO_TIMESTAMP(PARSE_JSON(31000000)); SELECT PARSE_JSON(31000000)::TIMESTAMP_NTZ;
        Copy

        첫 번째 쿼리에서 반환된 타임스탬프는 두 번째, 세 번째 쿼리에서 반환된 시간과 다릅니다.

        현지 타임존과 관계없이 변환하려면 아래와 같이 식의 정수에 명시적 캐스팅을 추가하십시오.

        SELECT TO_TIMESTAMP(31000000); SELECT TO_TIMESTAMP(PARSE_JSON(31000000)::INT); SELECT PARSE_JSON(31000000)::INT::TIMESTAMP_NTZ;
        Copy

        세 쿼리 모두에서 반환된 타임스탬프는 동일합니다. 이는 TIMESTAMP_NTZ로 형변환하거나 TO_TIMESTAMP_NTZ 함수를 호출하는지 여부에 적용됩니다. TIMESTAMP_TYPE_MAPPING 매개 변수가 TIMESTAMP_NTZ로 설정된 경우, TO_TIMESTAMP를 호출할 때도 적용됩니다.

        출력이 있는 예는 이 항목의 끝에 있는 예를 참조하십시오.

    • 변환이 불가능한 경우, 오류가 반환됩니다.

  • 타임존이 있는 타임스탬프의 경우 TIMEZONE 매개 변수의 설정이 반환 값에 영향을 줍니다. 반환된 타임스탬프는 세션의 타임존에 있습니다.

  • 출력의 타임스탬프 표시 형식은 함수(TIMESTAMP_OUTPUT_FORMAT, TIMESTAMP_LTZ_OUTPUT_FORMAT, TIMESTAMP_NTZ_OUTPUT_FORMAT 또는 TIMESTAMP_TZ_OUTPUT_FORMAT)에 해당하는 타임스탬프 출력 형식에 따라 결정됩니다.

  • 입력 매개 변수의 형식이 정수를 포함하는 문자열인 경우:

    • 문자열이 정수로 변환된 후 정수는 Unix epoch(1970-01-01 00:00:00.000000000 UTC) 시작 후의 초, 밀리초, 마이크로초 또는 나노초 단위 수로 처리됩니다.

      • 정수가 31536000000(1년의 밀리초 단위 수) 미만인 경우, 값은 초 단위 수로 처리됩니다.

      • 값이 31536000000 이상이고 31536000000000 미만인 경우, 값은 밀리초로 처리됩니다.

      • 값이 31536000000000 이상이고 31536000000000000 미만인 경우, 값은 마이크로초로 처리됩니다.

      • 값이 31536000000000000보다 큰 경우, 값은 나노초로 처리됩니다.

    • 둘 이상의 행이 평가되는 경우(예: 입력이 둘 이상의 행을 포함하는 테이블의 열 이름인 경우), 각각의 값을 독립적으로 검사해 값이 초, 밀리초, 마이크로초 또는 나노초를 나타내는지 확인합니다.

  • TO_TIMESTAMP_NTZ 또는 TRY_TO_TIMESTAMP_NTZ 함수를 사용하여 타임존 정보가 포함된 타임스탬프를 변환하면 타임존 정보가 손실됩니다. 타임스탬프가 타임존 정보가 포함된 타임스탬프로 다시 변환되면(예를 들어, TO_TIMESTAMP_TZ 함수를 사용하여) 타임존 정보를 복구할 수 없습니다.

예

이 예제는 TO_TIMESTAMP_TZ 가 세션의 타임존을 포함하는 타임스탬프를 만들지만, TO_TIMESTAMP_NTZ 의 값에는 타임존이 없음을 보여줍니다.

ALTER SESSION SET TIMEZONE = 'America/Los_Angeles';
Copy
SELECT TO_TIMESTAMP_TZ('2024-04-05 01:02:03');
Copy
+----------------------------------------+ | TO_TIMESTAMP_TZ('2024-04-05 01:02:03') | |----------------------------------------| | 2024-04-05 01:02:03.000 -0700 | +----------------------------------------+ 
SELECT TO_TIMESTAMP_NTZ('2024-04-05 01:02:03');
Copy
+-----------------------------------------+ | TO_TIMESTAMP_NTZ('2024-04-05 01:02:03') | |-----------------------------------------| | 2024-04-05 01:02:03.000 | +-----------------------------------------+

다음 예제는 다양한 형식이 모호한 날짜의 구문 분석에 어떤 영향을 미칠 수 있는지 보여줍니다. TIMESTAMP_TZ_OUTPUT_FORMAT 이 설정되어 있지 않아 TIMESTAMP_OUTPUT_FORMAT 이 사용되며 기본값(YYYY-MM-DD HH24:MI:SS.FF3 TZHTZM)으로 설정되어 있다고 가정해 보겠습니다.

이 예제에서는 입력 형식이 mm/dd/yyyy hh24:mi:ss (월/일/년)인 경우의 결과를 보여줍니다

SELECT TO_TIMESTAMP_TZ('04/05/2024 01:02:03', 'mm/dd/yyyy hh24:mi:ss');
Copy
+-----------------------------------------------------------------+ | TO_TIMESTAMP_TZ('04/05/2024 01:02:03', 'MM/DD/YYYY HH24:MI:SS') | |-----------------------------------------------------------------| | 2024-04-05 01:02:03.000 -0700 | +-----------------------------------------------------------------+

이 예제에서는 입력 형식이 dd/mm/yyyy hh24:mi:ss (일/월/년)인 경우의 결과를 보여줍니다

SELECT TO_TIMESTAMP_TZ('04/05/2024 01:02:03', 'dd/mm/yyyy hh24:mi:ss');
Copy
+-----------------------------------------------------------------+ | TO_TIMESTAMP_TZ('04/05/2024 01:02:03', 'DD/MM/YYYY HH24:MI:SS') | |-----------------------------------------------------------------| | 2024-05-04 01:02:03.000 -0700 | +-----------------------------------------------------------------+

이 예제는 1970년 1월 1일 자정부터 약 40년(Unix epoch의 시작)을 나타내는 숫자 입력을 사용하는 방법을 보여줍니다. 스케일이 지정되지 않았으므로 기본 스케일 0 (초)가 사용됩니다.

ALTER SESSION SET TIMESTAMP_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF9 TZH:TZM';
Copy
SELECT TO_TIMESTAMP_NTZ(40 * 365.25 * 86400);
Copy
+---------------------------------------+ | TO_TIMESTAMP_NTZ(40 * 365.25 * 86400) | |---------------------------------------| | 2010-01-01 00:00:00.000 | +---------------------------------------+

이 예제는 앞의 예제와 유사하지만 소수 자릿수 값을 3 으로 지정하여 값을 밀리초로 제공합니다.

SELECT TO_TIMESTAMP_NTZ(40 * 365.25 * 86400 * 1000 + 456, 3);
Copy
+-------------------------------------------------------+ | TO_TIMESTAMP_NTZ(40 * 365.25 * 86400 * 1000 + 456, 3) | |-------------------------------------------------------| | 2010-01-01 00:00:00.456 | +-------------------------------------------------------+

이 예에서는 동일한 숫자 값에 대해 다른 소수 자릿수 값을 지정하면 결과가 어떻게 변경되는지 보여줍니다.

SELECT TO_TIMESTAMP(1000000000, 0) AS "Scale in seconds", TO_TIMESTAMP(1000000000, 3) AS "Scale in milliseconds", TO_TIMESTAMP(1000000000, 6) AS "Scale in microseconds", TO_TIMESTAMP(1000000000, 9) AS "Scale in nanoseconds";
Copy
+-------------------------+-------------------------+-------------------------+-------------------------+ | Scale in seconds | Scale in milliseconds | Scale in microseconds | Scale in nanoseconds | |-------------------------+-------------------------+-------------------------+-------------------------| | 2001-09-09 01:46:40.000 | 1970-01-12 13:46:40.000 | 1970-01-01 00:16:40.000 | 1970-01-01 00:00:01.000 | +-------------------------+-------------------------+-------------------------+-------------------------+

이 예제에서는 입력이 정수가 포함된 문자열일 때 함수가 값의 크기에 따라 사용할 단위(초, 밀리초, 마이크로초 또는 나노초)를 결정하는 방법을 보여 줍니다.

다양한 범위 내의 정수를 포함하는 문자열이 있는 테이블을 생성하고 로딩합니다.

CREATE OR REPLACE TABLE demo1 ( description VARCHAR, value VARCHAR -- string rather than bigint ); INSERT INTO demo1 (description, value) VALUES ('Seconds', '31536000'), ('Milliseconds', '31536000000'), ('Microseconds', '31536000000000'), ('Nanoseconds', '31536000000000000');
Copy

함수에 문자열을 전달합니다.

SELECT description, value, TO_TIMESTAMP(value), TO_DATE(value) FROM demo1 ORDER BY value;
Copy
+--------------+-------------------+-------------------------+----------------+ | DESCRIPTION | VALUE | TO_TIMESTAMP(VALUE) | TO_DATE(VALUE) | |--------------+-------------------+-------------------------+----------------| | Seconds | 31536000 | 1971-01-01 00:00:00.000 | 1971-01-01 | | Milliseconds | 31536000000 | 1971-01-01 00:00:00.000 | 1971-01-01 | | Microseconds | 31536000000000 | 1971-01-01 00:00:00.000 | 1971-01-01 | | Nanoseconds | 31536000000000000 | 1971-01-01 00:00:00.000 | 1971-01-01 | +--------------+-------------------+-------------------------+----------------+

다음 예제에서는 값을 TIMESTAMP_NTZ로 형변환합니다. 예제에서는 정수 사용, 그리고 정수가 포함된 베리언트 사용 간의 동작 차이를 보여줍니다.

SELECT 0::TIMESTAMP_NTZ, PARSE_JSON(0)::TIMESTAMP_NTZ, PARSE_JSON(0)::INT::TIMESTAMP_NTZ;
Copy
+-------------------------+------------------------------+-----------------------------------+ | 0::TIMESTAMP_NTZ | PARSE_JSON(0)::TIMESTAMP_NTZ | PARSE_JSON(0)::INT::TIMESTAMP_NTZ | |-------------------------+------------------------------+-----------------------------------| | 1970-01-01 00:00:00.000 | 1969-12-31 16:00:00.000 | 1970-01-01 00:00:00.000 | +-------------------------+------------------------------+-----------------------------------+

반환된 타임스탬프는 첫 번째 및 세 번째 열의 정수와 정수로 형변환된 변형에 대해서는 일치하지만, 두 번째 열에서 정수로 형변환되지 않은 베리언트에 대해서는 반환된 타임스탬프가 다릅니다. 자세한 내용은 사용법 노트 섹션을 참조하십시오.

TO_TIMESTAMP_NTZ 함수를 호출할 때도 동일한 동작이 적용됩니다.

SELECT TO_TIMESTAMP_NTZ(0), TO_TIMESTAMP_NTZ(PARSE_JSON(0)), TO_TIMESTAMP_NTZ(PARSE_JSON(0)::INT);
Copy
+-------------------------+---------------------------------+--------------------------------------+ | TO_TIMESTAMP_NTZ(0) | TO_TIMESTAMP_NTZ(PARSE_JSON(0)) | TO_TIMESTAMP_NTZ(PARSE_JSON(0)::INT) | |-------------------------+---------------------------------+--------------------------------------| | 1970-01-01 00:00:00.000 | 1969-12-31 16:00:00.000 | 1970-01-01 00:00:00.000 | +-------------------------+---------------------------------+--------------------------------------+
언어: 한국어