1d9b3aeee7
The error format '##keyword' in a lot of docs. This pr is to repair document format. #4335
68 lines
2.5 KiB
Markdown
68 lines
2.5 KiB
Markdown
---
|
|
{
|
|
"title": "timestampdiff",
|
|
"language": "zh-CN"
|
|
}
|
|
---
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
-->
|
|
|
|
# timestampdiff
|
|
## description
|
|
### Syntax
|
|
|
|
`INT TIMESTAMPDIFF(unit,DATETIME datetime_expr1, DATETIME datetime_expr2)`
|
|
|
|
返回datetime_expr2−datetime_expr1，其中datetime_expr1和datetime_expr2是日期或日期时间表达式。
|
|
|
|
结果(整数)的单位由unit参数给出。interval的单位由unit参数给出，它应该是下列值之一:
|
|
|
|
SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, or YEAR。
|
|
|
|
## example
|
|
|
|
```
|
|
|
|
MySQL> SELECT TIMESTAMPDIFF(MONTH,'2003-02-01','2003-05-01');
|
|
+--------------------------------------------------------------------+
|
|
| timestampdiff(MONTH, '2003-02-01 00:00:00', '2003-05-01 00:00:00') |
|
|
+--------------------------------------------------------------------+
|
|
| 3 |
|
|
+--------------------------------------------------------------------+
|
|
|
|
MySQL> SELECT TIMESTAMPDIFF(YEAR,'2002-05-01','2001-01-01');
|
|
+-------------------------------------------------------------------+
|
|
| timestampdiff(YEAR, '2002-05-01 00:00:00', '2001-01-01 00:00:00') |
|
|
+-------------------------------------------------------------------+
|
|
| -1 |
|
|
+-------------------------------------------------------------------+
|
|
|
|
|
|
MySQL> SELECT TIMESTAMPDIFF(MINUTE,'2003-02-01','2003-05-01 12:05:55');
|
|
+---------------------------------------------------------------------+
|
|
| timestampdiff(MINUTE, '2003-02-01 00:00:00', '2003-05-01 12:05:55') |
|
|
+---------------------------------------------------------------------+
|
|
| 128885 |
|
|
+---------------------------------------------------------------------+
|
|
|
|
```
|
|
## keyword
|
|
TIMESTAMPDIFF
|