TO_TIMESTAMP
구문
TO_TIMESTAMP(char [ DEFAULT return_value ON CONVERSION ERROR ]
[, fmt [, 'nlsparam' ] ])
목적
TO_TIMESTAMP는 char를 TIMESTAMP 데이터 유형의 값으로 변환합니다.
char에 대해서는 CHAR, VARCHAR2, NCHAR 또는 NVARCHAR2 데이터 유형의 문자열로 평가되는 표현식을 지정할 수 있습니다.
선택적인 DEFAULT return_value ON CONVERSION ERROR 절을 사용하여 char를 TIMESTAMP으로 변환하는 동안 오류가 발생할 경우 이 함수가 반환하는 값을 지정할 수 있습니다. 이 절은 char를 평가하는 동안 오류가 발생할 경우에는 효과가 없습니다. return_value는 표현식 또는 바인드 변수일 수 있으며 CHAR, VARCHAR2, NCHAR, NVARCHAR2 데이터 유형 또는 null로 평가되어야 합니다. 이 함수는 char를 TIMESTAMP으로 변환하는 데 사용하는 방법과 동일한 방법으로 return_value를 TIMESTAMP으로 변환합니다. return_value가 TIMESTAMP으로 변환될 수 없는 경우 함수는 오류를 반환합니다.
선택적인 fmt는 char의 형식을 지정합니다. fmt를 생략하면 char는 TIMESTAMP 데이터 유형의 기본 형식이어야 합니다. TIMESTAMP 데이터 유형의 기본 형식은 NLS_TIMESTAMP_FORMAT 초기화 매개변수에 의해 결정됩니다. 선택적 'nlsparam' 인수는 이 함수에서 날짜 변환을 위한 TO_CHAR 함수와 동일한 목적을 가지고 있습니다.
이 함수는 CLOB 데이터를 직접 지원하지 않습니다. 그러나 CLOB는 암시적 데이터 변환을 통해 인수로 전달할 수 있습니다.
참고:
더 많은 정보는 "Data Type Comparison Rules"을 참조하십시오.
예제
다음 예제는 문자열을 타임스탬프로 변환합니다. 문자열은 기본 TIMESTAMP 형식이 아니므로 형식 마스크를 지정해야 합니다:
SELECT TO_TIMESTAMP ('10-Sep-02 14:10:10.123000', 'DD-Mon-RR HH24:MI:SS.FF')
FROM DUAL;
TO_TIMESTAMP('10-SEP-0214:10:10.123000','DD-MON-RRHH24:MI:SS.FF')
---------------------------------------------------------------------------
10-SEP-02 02.10.10.123000000 PM
다음 예제는 지정된 표현식이 잘못된 월 지정으로 인해 TIMESTAMP 값으로 변환할 수 없기 때문에 기본값으로 NULL을 반환합니다:
SELECT TO_TIMESTAMP ('10-Sept-02 14:10:10.123000'
DEFAULT NULL ON CONVERSION ERROR,
'DD-Mon-RR HH24:MI:SS.FF',
'NLS_DATE_LANGUAGE = American') "Value"
FROM DUAL;
참고:
기본 TIMESTAMP 형식에 대한 정보는 NLS_TIMESTAMP_FORMAT 초기화 매개변수를 참조하십시오. 또한 형식 마스크를 지정하는 방법에 대한 정보는 "Datetime Format Models"를 참조하십시오.
출처: 오라클 레퍼런스
원문 링크: Oracle TO_TIMESTAMP 함수 문서
'코딩 > 오라클 함수' 카테고리의 다른 글
[오라클 레퍼런스 함수] TO_UTC_TIMESTAMP_TZ - ISO 8601 날짜 형식 문자열을 TIMESTAMP WITH TIMEZONE의 인스턴스로 반환 (0) | 2023.09.01 |
---|---|
[오라클 레퍼런스 함수] TO_TIMESTAMP_TZ - TIMESTAMP WITH TIME ZONE 유형으로 변환 (0) | 2023.09.01 |
[오라클 레퍼런스 함수] TO_SINGLE_BYTE - 다중바이트 문자를 단일바이트 문자로 변환 (0) | 2023.09.01 |
[오라클 레퍼런스 함수] TO_NUMBER - NUMBER 유형으로 변환 (0) | 2023.09.01 |
[오라클 레퍼런스 함수] TO_NCLOB - CLOB 값 또는 문자열을 NCLOB 값으로 변환 (0) | 2023.08.31 |
댓글