ROUND

命令格式

DOUBLE|DECIMAL ROUND(DOUBLE|DECIMAL <number>[, BIGINT <decimal_places>])

-- 标准示例。
-- 返回125.32。
SELECT ROUND(125.315, 2);

参数说明

• number：必填。DOUBLE或DECIMAL类型。输入为STRING、BIGINT类型时，会隐式转换为DOUBLE类型后参与运算。

• decimal_places：可选。BIGINT类型常量，四舍五入计算到小数点后的位置。如果省略，则表示四舍五入到个位数，默认值为0。

  说明

  decimal_places可以是负数。负数会从小数点向左开始计数，并且返回值小数部分为0。如果负数值的绝对值等于或大于number整数部分长度，则返回0.0。

返回值说明

返回DOUBLE类型或DECIMAL类型。返回规则如下：

• number为DOUBLE、DECIMAL类型时会返回相应的类型。

  说明

  当number为DOUBLE类型参与计算时，因DOUBLE类型数值无法保证精度，ROUND函数处理结果可能会产生偏差。详情请参见ROUND函数精度问题案例。

• number为STRING、BIGINT类型时，返回DOUBLE类型。

• decimal_places非BIGINT类型时，返回报错。

• number或decimal_places值为NULL时，返回NULL。

使用示例

-- 返回125.0。
SELECT ROUND(125.315);

-- 返回125.3。
SELECT ROUND(125.315, 1);

-- 返回125.32。
SELECT ROUND(125.315, 2);

-- 返回125.315。
SELECT ROUND(125.315, 3);

-- 返回-125.32。
SELECT ROUND(-125.315, 2);

-- 四舍五入到百位。
-- 返回100.0。
SELECT ROUND(123.345, -2);

-- 返回NULL。
SELECT ROUND(NULL);

-- 精度超出原小数位，保留原值。
-- 返回123.345。
SELECT ROUND(123.345, 4);

-- 四舍五入到万位，数值不足则为0。
-- 返回0.0。
SELECT ROUND(123.345, -4);

相关函数

ROUND函数属于数学函数，更多数据计算、数据转换的相关函数请参见数学函数。