Skip to content

Commit 7dca17c

Browse files
codeDing18codeDing18
authored
add date_add minute_second time unit (#3113)
## Versions - [x] dev - [x] 4.x - [ ] 3.x - [ ] 2.1 ## Languages - [x] Chinese - [x] English ## Docs Checklist - [ ] Checked by AI - [ ] Test Cases Built
1 parent 35bc68d commit 7dca17c

File tree

4 files changed

+36
-4
lines changed
  • docs/sql-manual/sql-functions/scalar-functions/date-time-functions
  • i18n/zh-CN/docusaurus-plugin-content-docs
    • current/sql-manual/sql-functions/scalar-functions/date-time-functions
    • version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions
  • versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions

4 files changed

+36
-4
lines changed

‎docs/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
2929
| -- | -- |
3030
| `<date_or_time_expr>` | The date/time value to be processed. Supported types: datetime or date type, with a maximum precision of six decimal places for seconds (e.g., 2022-12-28 23:59:59.999999). For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
3131
| `<expr>` | The time interval to be added, of `INT` type |
32-
| `<time_unit>` | Enumeration values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR |
32+
| `<time_unit>` | Enumeration values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND |
3333

3434
## Return Value
3535

@@ -112,6 +112,14 @@ mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1 2' DAY_HOUR);
112112
| 2025-10-24 12:10:10 |
113113
+----------------------------------------------------------+
114114

115+
-- Add MINUTE_SECOND
116+
mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND);
117+
+---------------------------------------------------------------+
118+
| DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND) |
119+
+---------------------------------------------------------------+
120+
| 2025-10-23 10:11:11 |
121+
+---------------------------------------------------------------+
122+
115123
-- Illegal unit
116124
select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
117125
ERROR 1105 (HY000): errCode = 2, detailMessage =

‎i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
2929
| -- | -- |
3030
| `<date_or_time_expr>` | 待处理的日期/时间值。支持类型：为 datetime 或者 date 类型，最高有六位秒数的精度（如 2022-12-28 23:59:59.999999），具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion))|
3131
| `<expr>` | 希望添加的时间间隔，为 `INT` 类型|
32-
| `<time_unit>` | 枚举值：YEAR, QUARTER, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR |
32+
| `<time_unit>` | 枚举值：YEAR, QUARTER, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND |
3333

3434
## 返回值
3535

@@ -111,6 +111,14 @@ mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1 2' DAY_HOUR);
111111
| 2025-10-24 12:10:10 |
112112
+----------------------------------------------------------+
113113

114+
-- 添加 MINUTE_SECOND
115+
mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND);
116+
+---------------------------------------------------------------+
117+
| DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND) |
118+
+---------------------------------------------------------------+
119+
| 2025-10-23 10:11:11 |
120+
+---------------------------------------------------------------+
121+
114122
---非法单位
115123
select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
116124
ERROR 1105 (HY000): errCode = 2, detailMessage =

‎i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
2929
| -- | -- |
3030
| `<date_or_time_expr>` | 待处理的日期/时间值。支持类型：为 datetime 或者 date 类型，最高有六位秒数的精度（如 2022-12-28 23:59:59.999999），具体 datetime 和 date 格式请查看 [datetime 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) 和 [date 的转换](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion))|
3131
| `<expr>` | 希望添加的时间间隔，为 `INT` 类型|
32-
| `<time_unit>` | 枚举值：YEAR, QUARTER, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR |
32+
| `<time_unit>` | 枚举值：YEAR, QUARTER, MONTH, WEEK,DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND |
3333

3434
## 返回值
3535

@@ -111,6 +111,14 @@ mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1 2' DAY_HOUR);
111111
| 2025-10-24 12:10:10 |
112112
+----------------------------------------------------------+
113113

114+
-- 添加 MINUTE_SECOND
115+
mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND);
116+
+---------------------------------------------------------------+
117+
| DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND) |
118+
+---------------------------------------------------------------+
119+
| 2025-10-23 10:11:11 |
120+
+---------------------------------------------------------------+
121+
114122
---非法单位
115123
select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
116124
ERROR 1105 (HY000): errCode = 2, detailMessage =

‎versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/date-add.md‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ DATE_ADD(<date_or_time_expr>, <expr> <time_unit>)
2929
| -- | -- |
3030
| `<date_or_time_expr>` | The date/time value to be processed. Supported types: datetime or date type, with a maximum precision of six decimal places for seconds (e.g., 2022-12-28 23:59:59.999999). For specific datetime and date formats, please refer to [datetime conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
3131
| `<expr>` | The time interval to be added, of `INT` type |
32-
| `<time_unit>` | Enumeration values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR |
32+
| `<time_unit>` | Enumeration values: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, DAY_SECOND, DAY_HOUR, MINUTE_SECOND |
3333

3434
## Return Value
3535

@@ -112,6 +112,14 @@ mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1 2' DAY_HOUR);
112112
| 2025-10-24 12:10:10 |
113113
+----------------------------------------------------------+
114114

115+
-- Add MINUTE_SECOND
116+
mysql> select DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND);
117+
+---------------------------------------------------------------+
118+
| DATE_ADD('2025-10-23 10:10:10', INTERVAL '1:1' MINUTE_SECOND) |
119+
+---------------------------------------------------------------+
120+
| 2025-10-23 10:11:11 |
121+
+---------------------------------------------------------------+
122+
115123
-- Illegal unit
116124
select DATE_ADD('2023-12-31 23:00:00', INTERVAL 2 sa);
117125
ERROR 1105 (HY000): errCode = 2, detailMessage =

0 commit comments

Comments
 (0)