大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:MAKETIME

· 52CE 我爱测

返回一个TIME 类型的值,格式为 。当输入的 为整数类型,输出值精度为 0,当其为小数类型时,输出值精度为最大精度 6。

描述

返回根据hour, minute, second组合出的时间值

该函数与 mysql 中的 makedate 函数 行为一致。

语法

MAKETIME(`<hour>`, `<minute>`, `<second>`)

参数

参数 说明
hour 时间的小时部分,支持整数类型(BIGINT)。取值范围被限制在 [-838, 838], 若输入值超过该范围,则自动修正为最接近的边界值。
minute 时间的分钟部分,支持整数类型(BITINT)。允许的取值范围为 [0, 59]。
second 时间的秒数部分,支持整数(BIGINT)和小数类型(DOUBLE)。允许的取值范围为 [0, 60), 支持小数点后六位精度,若超过六位,会自动进行四舍五入。

返回值

返回一个TIME 类型的值,格式为 hour:minute:second。当输入的seconde为整数类型,输出值精度为 0,当其为小数类型时,输出值精度为最大精度 6。

  • 若minute 或 second 超过允许范围,返回 NULL
  • 任一参数为 NULL,返回 NULL

举例

SELECT `hour`, `minute`, `sec`, MAKETIME(`hour`, `minute`, `sec`) AS ans FROM `test_maketime`;
+-------+--------+---------+-------------------+
| hour  | minute | sec     | ans               |
+-------+--------+---------+-------------------+
|    12 |     15 |      30 | 12:15:30.000000   |
|    14 |     56 | 12.5789 | 14:56:12.578900   |
|  1234 |     11 |       4 | 838:59:59.000000  |
| -1234 |      6 |      52 | -838:59:59.000000 |
|    20 |     60 |      12 | NULL              |
|    14 |     51 |      66 | NULL              |
|  NULL |     15 |      16 | NULL              |
|     7 |   NULL |       8 | NULL              |
|     1 |      2 |    NULL | NULL              |
|    23 |    -40 |      12 | NULL              |
|    20 |      6 |     -12 | NULL              |
+-------+--------+---------+-------------------+

注:

  1. sec 列类型为 Float,所以输出格式全部为六位精度的时间值
  2. 1 - 2 为正常样例。
  3. 3 - 4 为 hour 越界情况样例(返回固定边界值)。
  4. 5 - 6 分别为 minute 参数和 sec 参数在正数区间超出合理范围的样例(返回 NULL)。
  5. 7 - 9 为任一参数为 NULL 的样例(返回 NULL)。
  6. 10 - 11 为 minute 和 sec 为负值的样例(即使绝对值合理也返回 NULL)
SELECT `id`, `hour`, `minute`, MAKETIME(`hour`, `minute`, 27) AS ans FROM `test_maketime`;
+------+-------+--------+------------+
| id   | hour  | minute | ans        |
+------+-------+--------+------------+
|    1 |    12 |     15 | 12:15:27   |
|    2 |    14 |     56 | 14:56:27   |
|    3 |  1234 |     11 | 838:59:59  |
|    4 | -1234 |      6 | -838:59:59 |
|    5 |    20 |     60 | NULL       |
|    6 |    14 |     51 | 14:51:27   |
|    7 |  NULL |     15 | NULL       |
|    8 |     7 |   NULL | NULL       |
|    9 |     1 |      2 | 01:02:27   |
|   10 |    23 |    -40 | NULL       |
|   11 |    20 |      6 | 20:06:27   |
+------+-------+--------+------------+

注: sec 的输入类型为正数类型,故输出类型均为不带微秒的时间类型

-- second的精度超过六位会四舍五入取六位精度
SELECT MAKETIME(12, 7, 56.1234567);
+-----------------------------+
| MAKETIME(12, 7, 56.1234567) |
+-----------------------------+
| 12:07:56.123457             |
+-----------------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。