MINUTE

更新时间:
复制 MD 格式

MINUTE函数用于提取指定日期值date中的分钟值(0~59)。

命令格式

INT MINUTE(DATETIME|TIMESTAMP|TIMESTAMP_NTZ|STRING|INTERVAL <date>)

-- 标准示例。
-- 返回46。
SELECT MINUTE('2025-03-05 10:46:00');

参数说明

date:必填。支持DATETIME、TIMESTAMP、TIMESTAMP_NTZ、STRING或INTERVAL类型。

  • STRING类型作为输入参数时,日期格式需包含hh:mi:ss。

  • INTERVAL类型作为输入参数时,仅支持INTERVAL_DAY_TIME,不支持INTERVAL_YEAR_MONTH。详情参考INTERVAL数据类型。

返回值说明

返回INT类型。返回规则如下:

  • date非DATETIME、TIMESTAMP、TIMESTAMP_NTZ、STRING或INTERVAL类型,返回NULL或报错。

  • date值为NULL时,返回NULL。

使用示例

  • 示例1:从标准时间中提取分钟。

    -- 返回45。
    SELECT MINUTE(DATETIME '2025-03-05 12:45:10');
  • 示例2:处理字符串时间输入。

    -- 返回15。
    SELECT MINUTE('2025-03-05 08:15:30');
  • 示例3:边界情况与NULL处理。

    -- 返回NULL。
    SELECT MINUTE(NULL);
    
    -- 最大分钟数测试。
    -- 返回59。
    SELECT MINUTE('2025-03-05 10:59:59');
  • 示例4:从INTERVAL_DAY_TIME中提取分钟值。

    -- 需开启2.0数据类型。
    SET odps.sql.type.system.odps2 = true;
    -- 返回30。
    SELECT MINUTE(INTERVAL '2 10:30:45' DAY TO SECOND);

相关函数

MINUTE函数属于时间函数,更多日期计算、日期转换的相关函数请参见日期函数。