MariaDB TIME_FORMAT() 函数使用指南

在 MariaDB 中，TIME_FORMAT() 是一个内置函数，它根据给定的格式格式化给定的时间。

MariaDB TIME_FORMAT() 语法

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

TIME_FORMAT(time, format)

参数

time
必需的。需要格式化的时间。
format
必需的。格式化模式字符串。

下表整理了 format 中可采用的格式化符号：

占位符 说明
%f 微秒 (000000..999999)
%H 小时 (00..23)
%h 小时 (01..12)
%I 小时 (01..12)
%i 分钟 (00..59)
%k 小时 (0..23)
%l 小时 (1..12)
%p AM 或者 PM
%r 十二小时制时间 (hh:mm:ss 后跟 AM 或 PM)
%S 秒 (00..59)
%s 秒 (00..59)
%T 二十四小时制时间 (hh:mm:ss)
%% 转义 %

如果您提供了错误数量的参数，MariaDB 将报告一个错误：ERROR 1582 (42000): Incorrect parameter count in the call to native function 'TIME_FORMAT'。

返回值

MariaDB TIME_FORMAT() 函数按照指定的格式格式化时间并返回格式化后的字符串。

如果其中任何一个参数为 NULL，TIME_FORMAT() 函数将返回 NULL。

MariaDB TIME_FORMAT() 示例

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

SELECT
    TIME_FORMAT("19:30:10", "%H %i %s"),
    TIME_FORMAT("19:30:10", "%h %i %s %p"),
    TIME_FORMAT("19:30:10", "%r"),
    TIME_FORMAT("19:30:10", "%T"),
    TIME_FORMAT("19:30:10", "%H %i %s")\G

输出：

   TIME_FORMAT("19:30:10", "%H %i %s"): 19 30 10
TIME_FORMAT("19:30:10", "%h %i %s %p"): 07 30 10 PM
         TIME_FORMAT("19:30:10", "%r"): 07:30:10 PM
         TIME_FORMAT("19:30:10", "%T"): 19:30:10
   TIME_FORMAT("19:30:10", "%H %i %s"): 19 30 10

这里又来了，但这次我们提供了一个更详细的格式字符串：

SELECT TIME_FORMAT(
    '10:30:45',
    '%H hours, %i minutes, and %S seconds'
    )
AS Result;

输出：

+--------------------------------------+
| Result                               |
+--------------------------------------+
| 10 hours, 30 minutes, and 45 seconds |
+--------------------------------------+

结论

在 MariaDB 中，TIME_FORMAT() 是一个内置函数，它根据给定的格式格式化给定的时间。