TO_ISO8601

설명

DATE, DATETIME, TIMESTAMP_NS 또는 TIMESTAMPTZ 값을 ISO8601 형식의 문자열로 변환합니다. 반환되는 ISO8601 형식의 날짜 및 시간은 YYYY-MM-DDTHH:MM:SS로 표현되며, T는 날짜와 시간을 구분하는 구분자입니다.

구문

TO_ISO8601(`<date_or_date_expr>`)

매개변수

매개변수	설명
<date_or_date_expr>	입력 날짜 및 시간 값으로, DATE/DATETIME/TIMESTAMP_NS/TIMESTAMPTZ 타입을 지원합니다. 구체적인 형식은 timestamptz 변환, datetime 변환 및 date 변환을 참조하세요.

반환값

ISO8601 형식의 날짜 및 시간 문자열을 나타내는 VARCHAR 타입을 반환합니다.

• 입력이 DATE(예: '2023-10-05')이면 YYYY-MM-DD 형식(날짜만)을 반환합니다;
• 입력이 DATETIME(예: '2023-10-05 15:30:25')이면 YYYY-MM-DDTHH:MM:SS.xxxxxx 형식을 반환합니다(날짜와 시간은 T로 구분되며, xxxxxx는 모두 영으로 표시되고, 입력 날짜 및 시간의 소수 초는 초 단위로 반올림됩니다);
• 입력이 TIMESTAMP_NS이면 YYYY-MM-DDTHH:MM:SS.nnnnnnnnn 형식을 반환하며, 소수 초의 아홉 자리를 모두 유지합니다;
• 입력이 TIMESTAMPTZ(예: '2023-10-05 15:30:25+03:00')이면 YYYY-MM-DDTHH:MM:SS.xxxxxx±HH:MM 형식을 반환합니다(local_time으로 변환한 후 세션 변수 time_zone에 따른 오프셋이 반영됩니다);
• 입력이 NULL이면 NULL을 반환합니다;

예제

-- Convert DATE type (date only)
SELECT TO_ISO8601(CAST('2023-10-05' AS DATE)) AS date_result;
+--------------+
| date_result  |
+--------------+
| 2023-10-05   |
+--------------+

-- Convert DATETIME type (with hours, minutes, seconds)
SELECT TO_ISO8601(CAST('2020-01-01 12:30:45' AS DATETIME)) AS datetime_result;
+----------------------------+
| datetime_result            |
+----------------------------+
| 2020-01-01T12:30:45.000000 |
+----------------------------+

-- Input with fractional seconds, rounded to seconds
SELECT TO_ISO8601(CAST('2020-01-01 12:30:45.956' AS DATETIME)) AS datetime_result;
+----------------------------+
| datetime_result            |
+----------------------------+
| 2020-01-01T12:30:46.000000 |
+----------------------------+

-- Input TIMESTAMPTZ, SET time_zone = '+08:00'
SELECT TO_ISO8601('2025-10-10 11:22:33+03:00');
+-----------------------------------------+
| TO_ISO8601('2025-10-10 11:22:33+03:00') |
+-----------------------------------------+
| 2025-10-10T16:22:33.000000+08:00        |
+-----------------------------------------+

-- Invalid date (returns NULL)
SELECT TO_ISO8601('2023-02-30') AS invalid_date;
+--------------+
| invalid_date |
+--------------+
| NULL         |
+--------------+

-- Input is NULL (returns NULL)
SELECT TO_ISO8601(NULL) AS null_input;
+------------+
| null_input |
+------------+
| NULL       |
+------------+