TO_DATE命令格式、參數和傳回值 - MaxCompute

將滿足format格式的字串，轉換成標準格式的日期值。

命令格式

DATETIME|DATE TO_DATE(STRING <date>[, STRING <format>])

參數說明

參數	是否必填	說明
date	是	STRING類型，滿足format格式的日期值。如果輸入為BIGINT、DOUBLE、DECIMAL或DATETIME類型，則會隱式轉換為STRING類型後參與運算。該函數還支援ISO8601時間格式的字串。
format	否	STRING類型常量，日期格式。format不支援日期擴充格式，其他字元在解析時當作無用字元忽略。說明 format參數格式：至少包含yyyy，且只能出現一次yyyy。否則會返回NULL。 `yyyy`為4位元的年，`mm`為2位元的月，`dd`為2位元的日，`hh`為24小時制的時，`mi`為2位元的分鐘，`ss`為2位元秒，`ff3`為3位精度毫秒。

傳回值說明

返回DATE或DATETIME類型：

當函數入參無format參數時，返回DATE類型，格式為yyyy-mm-dd。
當函數入參有format參數時，返回DATETIME類型，格式為yyyy-mm-dd hh:mi:ss。
當函數date或format值為NULL時，返回NULL。

使用樣本

待用資料樣本

-- 返回2025-01-29
SELECT TO_DATE('2025-01-29');

-- 返回2025-01-27 00:00:00
SELECT TO_DATE('阿里巴巴2025-01*27', '阿里巴巴yyyy-mm*dd');

-- 返回2025-01-12 00:00:00
SELECT TO_DATE('20250112', 'yyyymmdd');

-- 返回2025-01-28 12:12:00
SELECT TO_DATE('202501281212', 'yyyymmddhhmi');

-- 返回NULL。'2025112'無法轉為標準日期值，引發異常，應該為'20250112'
SELECT TO_DATE('2025112', 'yyyymmdd');

-- 返回NULL。'阿里巴巴2025-12*3'無法轉為標準日期值，引發異常，應該為'阿里巴巴2025-12*03'。
SELECT TO_DATE('阿里巴巴2025-12*3', '阿里巴巴yyyy-mm*dd');

-- 返回NULL。'2025-24-01'無法轉為標準日期值，引發異常，應該為'2025-01-24'。
SELECT TO_DATE('2025-24-01', 'yyyy');

-- 返回2025-10-30 15:13:12
SELECT TO_DATE('20251030 15-13-12.345','yyyymmdd hh-mi-ss.ff3');

-- 返回NULL。
SELECT TO_DATE(NULL, 'yyyymmdd hh-mi-ss.ff3');

-- 返回NULL。
SELECT TO_DATE('20251030 15-13-12.345', NULL);

-- 返回ISO8601時間格式，2025-09-24 13:39:34
SELECT TO_DATE('2025-09-24T13:39:34.119Z', 'yyyy-MM-ddThh:mi:ss.ff3Z');

表資料樣本

樣本資料。

CREATE TABLE IF NOT EXISTS mf_date_fun_t(
    id      INT,
    date1   DATE,
    datetime1   DATETIME,
    timestamp1 TIMESTAMP,
    date2   DATE,
    datetime2   DATETIME,
    timestamp2 TIMESTAMP,
    date3 STRING,
    date4 BIGINT);

INSERT INTO mf_date_fun_t VALUES 
(1,DATE'2021-11-29',DATETIME'2021-11-29 00:01:00',TIMESTAMP'2021-01-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-20',123456780),
(2,DATE'2021-11-28',DATETIME'2021-11-28 00:02:00',TIMESTAMP'2021-02-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-21',123456781),
(3,DATE'2021-11-27',DATETIME'2021-11-27 00:03:00',TIMESTAMP'2021-03-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-22',123456782),
(4,DATE'2021-11-26',DATETIME'2021-11-26 00:04:00',TIMESTAMP'2021-04-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-23',123456783),
(5,DATE'2021-11-25',DATETIME'2021-11-25 00:05:00',TIMESTAMP'2021-05-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-24',123456784),
(6,DATE'2021-11-24',DATETIME'2021-11-24 00:06:00',TIMESTAMP'2021-06-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-25',123456785),
(7,DATE'2021-11-23',DATETIME'2021-11-23 00:07:00',TIMESTAMP'2021-07-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-26',123456786),
(8,DATE'2021-11-22',DATETIME'2021-11-22 00:08:00',TIMESTAMP'2021-08-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-27',123456787),
(9,DATE'2021-11-21',DATETIME'2021-11-21 00:09:00',TIMESTAMP'2021-09-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-28',123456788),
(10,DATE'2021-11-20',DATETIME'2021-11-20 00:10:00',TIMESTAMP'2021-10-11 00:00:00.123456789',DATE'2021-10-29',DATETIME'2021-10-29 00:00:00',TIMESTAMP'2021-10-11 00:00:00.123456789','2021-11-29',123456789);

將STRING類型的date3欄位，轉換為DATETIME類型的date3_to_date進行一併輸出。

SELECT date3, TO_DATE(date3, 'yyyy-mm-dd') AS date3_to_date FROM mf_date_fun_t;

返回結果如下：

+------------+---------------------+
| date3      | date3_to_date       |
+------------+---------------------+
| 2021-11-20 | 2021-11-20 00:00:00 |
| 2021-11-21 | 2021-11-21 00:00:00 |
| 2021-11-22 | 2021-11-22 00:00:00 |
| 2021-11-23 | 2021-11-23 00:00:00 |
| 2021-11-24 | 2021-11-24 00:00:00 |
| 2021-11-25 | 2021-11-25 00:00:00 |
| 2021-11-26 | 2021-11-26 00:00:00 |
| 2021-11-27 | 2021-11-27 00:00:00 |
| 2021-11-28 | 2021-11-28 00:00:00 |
| 2021-11-29 | 2021-11-29 00:00:00 |
+------------+---------------------+

MaxCompute：TO_DATE

命令格式

參數說明

傳回值說明

使用樣本

待用資料樣本

表資料樣本

相關函數