第120章 SQL函数 ROUND
以指定位数舍入或截断数字的数值函数。
大纲
ROUND(numeric-expr,scale[,flag])
{fn ROUND(numeric-expr,scale[,flag])}
参数
numeric-expr- 要四舍五入的数字。一个数值表达式。scale- 计算结果为整数的表达式，该整数指定要舍入到的位数，从小数点开始计数。可以是零、正整数或负整数。如果scale是小数， 会将其四舍五入为最接近的整数。flag- 可选 — 一个布尔标志，指定是舍入还是截断numeric-expr：0=round, 1=truncate。默认值为0。
ROUND 返回与 numeric-expr 相同的数据类型。
描述
此函数可用于将数字舍入或截断为指定的小数位数。
ROUND 将 numeric-expr 舍入或截断以缩放位置，从小数点开始计数。舍入时，数字 5 始终向上舍入。在 ROUND 循环或截断操作后删除尾随零。不返回前导零。
- 如果
scale为正数，则在小数点右侧的该位数处进行舍入。如果scale等于或大于小数位数，则不会发生舍入或零填充。 - 如果
scale为零，则舍入到最接近的整数。换句话说，在小数点右边的零位处进行舍入；所有小数位和小数点本身都被删除。 - 如果
scale为负数，则在小数点左侧的该位数处进行舍入。如果scale等于或大于舍入结果中的整数位数，则返回零。 - 如果
numeric-expr为零（但表示为：00.00、-0等），ROUND将返回0（零）且没有小数位，而不管比例值如何。 - 如果
numeric-expr或scale为NULL，ROUND返回NULL。
请注意，ROUND 返回值始终是标准化的，删除尾随零。
ROUND、TRUNCATE 和 $JUSTIFY
ROUND 和 TRUNCATE 是执行类似操作的数值函数；它们都可用于减少数字的有效小数位数或整数位数。 ROUND 允许指定舍入（默认）或截断； TRUNCATE 不执行舍入。 ROUND 返回与 numeric-expr 相同的数据类型； TRUNCATE 返回 numeric-expr 作为数据类型 NUMERIC，除非 numeric-expr 是数据类型 DOUBLE，在这种情况下它返回数据类型 DOUBLE。
ROUND 舍入（或截断）到指定数量的小数位数，但其返回值始终是标准化的，删除尾随零。例如，ROUND(10.004,2) 返回 10，而不是 10.00。
TRUNCATE 截断到指定数量的小数位数。如果截断导致尾随零，则保留这些尾随零。但是，如果 scale 大于 numeric-expr 规范形式的小数位数，则 TRUNCATE 不会填充零。
当舍入到固定的小数位数很重要时使用 $JUSTIFY - 例如，在表示货币金额时。 $JUSTIFY 在舍入操作之后返回指定数量的尾随零。当要舍入的位数大于小数位数时，$JUSTIFY 补零。 $JUSTIFY 还右对齐数字，以便 DecimalSeparator 字符在一列数字中对齐。 $JUSTIFY 不会截断。
$DOUBLE 数字
$DOUBLE IEEE 浮点数使用二进制表示法编码。大多数十进制分数不能用这种二进制表示法精确表示。当 $DOUBLE 值被输入到带有刻度值和舍入标志（flag = 0，默认值）的 ROUND 时，返回值通常包含比刻度中指定的更多的小数位数，因为小数位数的结果不能用二进制表示，所以返回值必须四舍五入到最接近的可表示的 $DOUBLE 值，如以下示例所示：
/// d ##class(PHA.TEST.SQLFunction).Round()
ClassMethod Round()
{
s x = 1234.5678
s y = $DOUBLE(1234.5678)
&sql(SELECT ROUND(:x,2),ROUND(:y,2) INTO :decnum,:dblnum)
w "Decimal: ",x," rounded ",decnum,!
w "Double: ",y," rounded ",dblnum
}
DHC-APP>d ##class(PHA.TEST.SQLFunction).Round()
Decimal: 1234.5678 rounded 1234.57
Double: 1234.5678000000000338 rounded 1234.5699999999999363
如果使用 ROUND 截断 $DOUBLE 值（标志 = 1），则 $DOUBLE 的返回值将被截断为小数位数指定的小数位数。 TRUNCATE 函数还将 $DOUBLE 截断为由 scale 指定的小数位数。
如果使用 ROUND 对 $DOUBLE 值进行舍入并希望返回特定的比例，则应在舍入结果之前将 $DOUBLE 值转换为十进制表示。
带有 flag=0 的 ROUND（round，默认值）返回 $DOUBLE("INF") 和 $DOUBLE("NAN") 作为空字符串。
如果使用 ROUND 对 $DOUBLE 值进行舍入并希望返回特定的比例，则应在舍入结果之前将 $DOUBLE 值转换为十进制表示。
带有 flag=0 的 ROUND（round，默认值）返回 $DOUBLE("INF") 和 $DOUBLE("NAN") 作为空字符串。
带有 flag=1（截断）的 ROUND 返回 $DOUBLE("INF") 和 $DOUBLE("NAN") 作为 INF 和 NAN。
示例
以下示例使用 0（零）的比例将多个分数舍入为整数。它表明 5 总是向上取整：
SELECT ROUND(5.99,0) AS RoundUp,
ROUND(5.5,0) AS Round5,
{fn ROUND(5.329,0)} AS Roundoff
6 6 5
以下示例截断与上一个示例相同的小数：
SELECT ROUND(5.99,0,1) AS Trunc1,
ROUND(5.5,0,1) AS Trunc2,
{fn ROUND(5.329,0,1)} AS Trunc3
5 5 5
以下 ROUND 函数对负小数进行舍入和截断：
SELECT ROUND(-0.987,2,0) AS Round1,
ROUND(-0.987,2,1) AS Trunc1
-0.99 -0.98
以下示例将 pi 舍入为四位小数：
SELECT {fn PI()} AS ExactPi, ROUND({fn PI()},4) AS ApproxPi
3.141592653589793238 3.1416
以下示例指定了大于十进制位数的比例：
SELECT {fn ROUND(654.98700,9)} AS Rounded
654.987
它返回 654.987（ 在舍入操作之前删除了尾随零；没有发生舍入或零填充）。
以下示例将 Salary 的值四舍五入到最接近的千美元：
SELECT Salary,ROUND(Salary, -3) AS PayBracket
FROM Sample.Employee
ORDER BY Salary
请注意，如果 Salary 小于 500 美元，则四舍五入为 0（零）。
在下面的示例中，每个 ROUND 都指定一个与要舍入的数字一样大或更大的负比例：
SELECT {fn ROUND(987,-3)} AS Round1,
{fn ROUND(487,-3)} AS Round2,
{fn ROUND(987,-4)} AS Round3,
{fn ROUND(987,-5)} AS Round4
1000 0 0 0
第一个 ROUND 函数返回 1000，因为舍入结果的位数多于小数位数。其他三个 ROUND 函数返回 0（零）。
