DATE_SUB（Lakehouse v1）

从指定的日期或带时间的日期（timestamp/datetime）中减去时间间隔或日期间隔。

Analyze 语法

func.date_sub(<unit>, <value>,  <date_or_time_expr>)

Analyze 示例

func.date_sub('YEAR', 1, func.to_date('2018-01-02'))
┌──────────────────────────────────────────────────────┐
│ func.date_sub('YEAR', 1, func.to_date('2018-01-02')) │
├──────────────────────────────────────────────────────┤
│ 2017-01-02                                           │
└──────────────────────────────────────────────────────┘

SQL 语法

DATE_SUB(<unit>, <value>,  <date_or_time_expr>)

参数

参数	说明
<unit>	必须是以下值之一：YEAR、QUARTER、MONTH、DAY、HOUR、MINUTE 和 SECOND
<value>	要增加的时间单位数量。例如，要增加 2 天，此值为 2。
<date_or_time_expr>	DATE 或 TIMESTAMP 类型的值

返回类型

函数返回与 <date_or_time_expr> 参数相同类型的值。

SQL 示例

SELECT date_sub(YEAR, 1, to_date('2018-01-02'));
┌───────────────────────────────────────────────────┐
│ DATE_SUB(YEAR, INTERVAL 1, to_date('2018-01-02')) │
├───────────────────────────────────────────────────┤
│ 2017-01-02                                        │
└───────────────────────────────────────────────────┘