TO_DATE

引入或更新版本：v1.1.39

将表达式转换为日期，包括：

• 将时间戳格式字符串转换为日期：从给定字符串中提取日期。

• 将整数转换为日期：将整数解释为Unix纪元（1970年1月1日午夜）之前（对于负数）或之后（对于正数）的天数。请注意，Date值的范围从1000-01-01到9999-12-31。如果运行"SELECT TO_DATE(9999999999999999999)"，Databend会返回错误。

• 使用指定格式将字符串转换为日期：该函数接受两个参数，根据第二个字符串中指定的格式将第一个字符串转换为日期。为了在Databend中自定义日期和时间格式，可以使用指定符。有关支持的指定符的全面列表，请参见格式化日期和时间。

另见：TO_TIMESTAMP

语法

-- 转换时间戳格式字符串
TO_DATE('<timestamp_expr>')

-- 转换整数
TO_DATE(<integer>)

-- 使用给定格式转换字符串
TO_DATE('<string>', '<format>')

别名

• DATE
• STR_TO_DATE

返回类型

该函数返回格式为"YYYY-MM-DD"的日期：

SELECT TYPEOF(TO_DATE('2022-01-02')), TYPEOF(STR_TO_DATE('2022-01-02'));

┌───────────────────────────────────────────────────────────────────┐
│ typeof(to_date('2022-01-02')) │ typeof(str_to_date('2022-01-02')) │
├───────────────────────────────┼───────────────────────────────────┤
│ DATE                          │ DATE                              │
└───────────────────────────────────────────────────────────────────┘

要将返回的日期转换回字符串，请使用DATE_FORMAT函数：

SELECT DATE_FORMAT(TO_DATE('2022-01-02')) AS dt, TYPEOF(dt);

┌─────────────────────────┐
│     dt     │ typeof(dt) │
├────────────┼────────────┤
│ 2022-01-02 │ VARCHAR    │
└─────────────────────────┘

示例

示例 1：转换时间戳格式字符串

SELECT TO_DATE('2022-01-02T01:12:00+07:00'), STR_TO_DATE('2022-01-02T01:12:00+07:00');

┌─────────────────────────────────────────────────────────────────────────────────┐
│ to_date('2022-01-02t01:12:00+07:00') │ str_to_date('2022-01-02t01:12:00+07:00') │
├──────────────────────────────────────┼──────────────────────────────────────────┤
│ 2022-01-01                           │ 2022-01-01                               │
└─────────────────────────────────────────────────────────────────────────────────┘

SELECT TO_DATE('2022-01-02'), STR_TO_DATE('2022-01-02');

┌───────────────────────────────────────────────────┐
│ to_date('2022-01-02') │ str_to_date('2022-01-02') │
├───────────────────────┼───────────────────────────┤
│ 2022-01-02            │ 2022-01-02                │
└───────────────────────────────────────────────────┘

示例 2：转换整数

SELECT TO_DATE(1), STR_TO_DATE(1), TO_DATE(-1), STR_TO_DATE(-1);

┌───────────────────────────────────────────────────────────────────┐
│ to_date(1) │ str_to_date(1) │ to_date((- 1)) │ str_to_date((- 1)) │
│    Date    │      Date      │      Date      │        Date        │
├────────────┼────────────────┼────────────────┼────────────────────┤
│ 1970-01-02 │ 1970-01-02     │ 1969-12-31     │ 1969-12-31         │
└───────────────────────────────────────────────────────────────────┘

示例 3：使用给定格式转换字符串

SELECT TO_DATE('12/25/2022','%m/%d/%Y'), STR_TO_DATE('12/25/2022','%m/%d/%Y');

┌───────────────────────────────────────────────────────────────────────────┐
│ to_date('12/25/2022', '%m/%d/%y') │ str_to_date('12/25/2022', '%m/%d/%y') │
├───────────────────────────────────┼───────────────────────────────────────┤
│ 2022-12-25                        │ 2022-12-25                            │
└───────────────────────────────────────────────────────────────────────────┘