TO_DAYS

📄字数 537

👁️阅读量 加载中...

功能描述

计算从 0000-00-00 开始到指定日期的天数。

提示

• 函数使用限制：不支持公元前的日期。

语法格式

TO_DAYS(expr)

输入参数

• expr：DATE 或 DATETIME WITH TIME ZONE 类型，或能隐式转换为 DATE 或 DATETIME WITH TIME ZONE 类型的其他类型，参数取值范围：[0001-01-01 00:00:00.000000, 9999-12-31 23:59:59.999999]。

提示

• 因 NULL 无具体的类型，当参数为 NULL 时，会产生异常 E10100 候选函数出现多义性，需要手动为参数指定具体的形参类型，如：TO_DAYS(NULL::DATE)。

输出结果

返回 INTEGER 类型，返回值范围：[366, 3652424]，输入参数为 NULL 时，输出结果为 NULL。

示例

-- 返回从日期 '0000-00-00' 至 '0001-01-01' 的天数
SQL> SELECT TO_DAYS('0001-01-01');

+-------+
| EXPR1 |
+-------+
| 366   |
+-------+

-- 返回从日期 '0000-00-00' 至 '2022-01-01 12:34:56' 的天数
SQL> SELECT TO_DAYS('2022-01-01 12:34:56');

+--------+
| EXPR1  |
+--------+
| 738521 |
+--------+

-- 返回从日期 '0000-00-00' 至 '2022-01-01 12:34:56 +08:00' 的天数
SQL> SELECT TO_DAYS('2022-01-01 12:34:56 +08:00');

+--------+
| EXPR1  |
+--------+
| 738521 |
+--------+