文章
姚 鑫 · 四月 22 阅读大约需 5 分钟

第120章 SQL函数 ROUND

第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 相同的数据类型。

描述

此函数可用于将数字舍入或截断为指定的小数位数。

ROUNDnumeric-expr 舍入或截断以缩放位置,从小数点开始计数。舍入时,数字 5 始终向上舍入。在 ROUND 循环或截断操作后删除尾随零。不返回前导零。
- 如果 scale 为正数,则在小数点右侧的该位数处进行舍入。如果 scale 等于或大于小数位数,则不会发生舍入或零填充。
- 如果 scale 为零,则舍入到最接近的整数。换句话说,在小数点右边的零位处进行舍入;所有小数位和小数点本身都被删除。
- 如果 scale 为负数,则在小数点左侧的该位数处进行舍入。如果 scale 等于或大于舍入结果中的整数位数,则返回零。
- 如果 numeric-expr 为零(但表示为:00.00-0 等),ROUND将返回 0(零)且没有小数位,而不管比例值如何。
- 如果 numeric-exprscaleNULLROUND 返回 NULL

请注意,ROUND 返回值始终是标准化的,删除尾随零。

ROUND、TRUNCATE 和 $JUSTIFY

ROUNDTRUNCATE 是执行类似操作的数值函数;它们都可用于减少数字的有效小数位数或整数位数。 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=0ROUNDround,默认值)返回 $DOUBLE("INF")$DOUBLE("NAN") 作为空字符串。

如果使用 ROUND$DOUBLE 值进行舍入并希望返回特定的比例,则应在舍入结果之前将 $DOUBLE 值转换为十进制表示。

带有 flag=0ROUNDround,默认值)返回 $DOUBLE("INF")$DOUBLE("NAN") 作为空字符串。

带有 flag=1(截断)的 ROUND 返回 $DOUBLE("INF")$DOUBLE("NAN") 作为 INFNAN

示例

以下示例使用 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

image

请注意,如果 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(零)。

0
0 14
讨论 (0)1
登录或注册以继续