TO_DATE

将满足format格式的字符串,转换成标准格式的日期值。

命令格式

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

参数说明

参数

是否必填

说明

date

STRING类型,满足format格式的日期值。如果输入为BIGINT、DOUBLE、DECIMALDATETIME类型,则会隐式转换为STRING类型后参与运算。该函数还支持ISO8601时间格式的字符串。

format

STRING类型常量,日期格式。format不支持日期扩展格式,其他字符在解析时当作无用字符忽略。

说明

format参数格式:

  • 至少包含yyyy,且只能出现一次yyyy。否则会返回NULL。

  • yyyy4位数的年,mm2位数的月,dd2位数的日,hh24小时制的时,mi2位数的分钟,ss2位数秒,ff33位精度毫秒。

返回值说明

返回DATEDATETIME类型:

  • 当函数入参无format参数时,返回DATE类型,格式为yyyy-mm-dd

  • 当函数入参有format参数时,返回DATETIME类型,格式为yyyy-mm-dd hh:mi:ss

  • 当函数dateformat值为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');

表数据示例

  1. 示例数据。

    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);
  2. 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 |
    +------------+---------------------+

相关函数

TO_DATE函数属于日期函数,更多日期计算、日期转换的相关函数请参见日期函数