MariaDB TIME() 函数使用指南

在 MariaDB 中，TIME() 是一个内置函数，它从给定的时间或日期时间表达式中提取时间部分并将其作为字符串返回。

MariaDB `TIME()` 语法

这是 MariaDB TIME() 函数的语法：

TIME(expr)

参数

expr: 必需的。一个日期或者日期时间表达式。

如果您提供了错误数量的参数，MariaDB 将报告一个错误：ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ')' at line 1。

返回值

MariaDB TIME() 函数返回指定的时间或者日期时间中的时间部分。

如果指定的表达式不是一个合法的时间或者日期时间，TIME() 函数将返回 NULL。

如果参数为 NULL，TIME() 函数将返回 NULL。

MariaDB `TIME()` 示例

示例 1 - 日期时间

下面的语句展示了 MariaDB TIME() 的基本用法：

SELECT TIME('2023-01-31 10:11:12');

输出：

+-----------------------------+
| TIME('2023-01-31 10:11:12') |
+-----------------------------+
| 10:11:12                    |
+-----------------------------+

示例 2 - 时间

MariaDB TIME() 的允许您从时间值中提取时间：

SELECT TIME('10:11:12');

输出：

+------------------+
| TIME('10:11:12') |
+------------------+
| 10:11:12         |
+------------------+

示例 3 - 小说秒

MariaDB TIME() 的允许您从带有小数秒的时间表达式中提取时间：

SELECT
  TIME('2023-01-31 10:11:12.123'),
  TIME('10:11:12.123456');

输出：

+---------------------------------+-------------------------+
| TIME('2023-01-31 10:11:12.123') | TIME('10:11:12.123456') |
+---------------------------------+-------------------------+
| 10:11:12.123                    | 10:11:12.123456         |
+---------------------------------+-------------------------+

示例 4 - 日期

如果您提供了一个日期表达式，MariaDB TIME() 的将最前面的数字作为时间返回：

SELECT TIME('2021-01-01');

输出：

+--------------------+
| TIME('2021-01-01') |
+--------------------+
| 00:20:21           |
+--------------------+

示例 5 - 超出范围

MariaDB 支持的时间范围从 '-838:59:59.999999' 到 '838:59:59.999999'，因此 TIME() 最大的返回值为 '838:59:59.999999'。

SELECT TIME('10:11:12'), TIME('839:11:12');

输出：

+------------------+-------------------+
| TIME('10:11:12') | TIME('839:11:12') |
+------------------+-------------------+
| 10:11:12         | 838:59:59         |
+------------------+-------------------+

在本示例中，由于 839:11:12 超出了范围，因此 TIME() 返回了 838:59:59。

结论