ROUND 函数

下图展示 ROUND 和 TRUNC 代数函数的语法，它们支持相同的语法。然而，由于它们的语义不同，它们可从相同的参数列表返回不同的值。仅 ROUND 可返回大于它的第一个参数的绝对值。

ROUND 和 TRUNC 代数函数

元素	描述	限制	语法
date_expression	求值为（或强制转型为）DATE 值的表达式	必须返回 DATE 值	表达式
datetime_expression	求值为（或强制转型为）DATETIME 值的表达式	必须返回 DATETIME 值	表达式
factor	在返回的值中以零替代的有效数字的数目。缺省的是返回四舍五入的或截断的第一个参数的整数部分。	取值范围为 +32 至 -32 的整数。正值或无符号值适用于小数点的右边，而负值适用于左边。	文字的数值
num_expression	求值为（或强制转型为）数值值的表达式	实数	表达式

用法

ROUND 函数与 TRUNC 函数相似，其语法如上所示。然而，ROUND 的不同之处在于它如何处理精度之内小于最小有效数字或时间单位的它的第一个参数的任何部分，它的显式的或缺省的第二个参数指定该精度。

如果此部分的绝对值等于或大于该精度内最小单位的一半，则那个数字或时间单位的值为由 ROUND 返回的值中增加 1。然而，如果这部分小于一个单位的一半，则丢弃它，仅返回指定的或缺省的精度之内第一个参数的数值或时间单位。
也就是说，如果第一个参数大于零，则
- ROUND 函数舍去在第二个参数的精度之内小于最小有效数字或时间的一半单位的它的第一个参数的任何部分，
- 但向上舍入等于或大于半个单位的第一个参数的任何部分。
例如，ROUND(3.5,0) = 4 且 ROUND(3.4,0) = 3。
但如果第一个参数小于零，则
- ROUND 函数向上舍入在第二个参数的精度之内的小于最小有效数字或时间单位的半个单位的它的第一个参数的任何部分，
- 但舍去等于或大于半个单位的第一个参数的任何部分。
例如，ROUND(-3.5,0) = -4 而 ROUND(-3.4,0) = -3。
相反地，TRUNC 函数以零替代数值表达式的小于指定精度的任何数值。对于 DATE 或 DATETIME 表达式，TRUNC 替换小于指定格式字符串的任何时间单位，以 1 替换 month 或 day 时间单位，或以零替换小于 day 的时间单位。

ROUND 函数可接受可选的第二个参数，其指定返回的值的精度。第二个参数的语法和语义依赖于第一个字符是否为数值表达式、DATETIME 表达式或 DATE 表达式。

对数值和 MONEY 值的四舍五入

当第一个参数是数值表达式时，返回的值是 DECIMAL，且第二个参数可为取值范围从 -32 至 +32 （包含 -32 和 +32）的整数，指定返回的值的最后有效数字（相对于小数点）的位置。当第一个参数是数值时，如果您省略 factor 规范，则 ROUND 返回舍入到个位或单位位置的第一个参数的整数值。
正的数字值指定舍入到小数点的右边；负的数值值指定舍入到小数点的左边，如图 1 所示：

图: 负的、零和正的舍入因子的示例
下列示例使用带有列表达式作为它的第一个参数且没有第二个参数的 ROUND 函数，因此，数值表达式被舍入到范围零。此查询返回订单号和其总价（四舍五入到缺省的个位）等于 $124.00 的项的四舍五入的总价。
```
SELECT order_num , ROUND(total_price) FROM items
                    WHERE ROUND(total_price) = 124.00;
```
如果您使用 MONEY 数据类型作为 ROUND 函数的参数，且四舍五入到显式的或缺省的个位，则返回的值以 .00 表示小数部分。下列示例中的 SELECT 语句四舍五入 125.46 和 MONEY 列值。该查询返回 125 和 items 表中每一行的 xxx.00 形式的四舍五入的价格。
```
SELECT ROUND(125.46), ROUND(total_price) FROM items;
```

DATE 和 DATETIME 值的四舍五入

当 ROUND 的第一个参数为 DATETIME 表达式时，返回的值是 DATETIME YEAR TO MINUTE 数据类型，且第二个参数必须为在返回的值中指定最小有效时间单位的引用的字符串。如果您省略第二个参数，则缺省的格式字符串为 'DD'，以四舍五入到 00:00 的小时和分钟指定最近的一天。下列格式字符串作为第二个参数是有效的：

表 1. ROUND 函数的 DATETIME 参数的格式字符串
格式字符串	对返回的 DATETIME 值的影响
'`YEAR`'	舍入到最近一年之初，以六月 30 日之后的日期舍入到下一年。month、day、hour 和 minute 值舍入为 `-01-01 00:00`。
'`MONTH`'	舍入到最近一月之初。将 15 日以后的日期舍入到下一月。day、hour 和 minute 值舍入为 `01 00:00`。
'`DD`'	舍入到最近一天之初（`00:00` = midnight）。将中午 12:00 之后的 DATETIME 舍入到下一天。
'`DAY`'	舍入到最近的星期天之初。周三、周四、周五或周六的日期舍入到下一星期天。
'`HH`'	舍入到最近一小时之初。以 minute:second 晚于 `29:59` 的时间值舍入到下一小时。分钟舍入为零。
'`MI`'	舍入到最近一分钟之初。以 second 晚于 `30` 的时间值舍入到下一分钟。

如果您在初始的 DATETIME 表达式参数之后省略格式字符串规范，则返回的值是将第一个参数舍入到最近一天的值，就如同您已指定了 'DD' 作为格式字符串。

下列示例在 SELECT 语句中使用带有返回 DATETIME YEAR TO FRACTION(5) 值的列表达式的 ROUND 函数。在这些查询中，表 mytab 仅有单个行，且在那行中，mytab.col_dt 的值是 2012-12-07 14:30:12.12300。

下列查询指定 'YEAR' 作为 DATETIME 格式字符串：

SELECT ROUND(col_dt, 'YEAR') FROM mytab;

返回的值为 2013-01-01 00:00。

下一查询与前面的查询相似，但将返回的值强制转型为 DATE 数据类型：

SELECT ROUND(col_dt, 'YEAR')::DATE FROM mytab;

返回的值为 01/01/2013。

此示例指定 'MONTH' 作为 DATETIME 格式字符串：

SELECT ROUND(col_dt, 'MONTH') FROM mytab;

返回的值为 2012-12-01 00:00。

此示例将 DATETIME 表达式舍入到 YEAR TO HOUR 精度：

SELECT ROUND(col_dt, 'HH') FROM mytab;

返回的值为 2012-12-07 15:00。

如果第二个参数是在返回的值中指定最小时间单位的引用字符串，则当第一个参数为 DATE 表达式时，返回的值也是 DATE 数据类型。这些是与舍入 DATETIME 值相同的格式字符串，除了 'HH' 和 'MI' 不是有效的 DATE 值之外。对于舍入 DATE 参数，没有缺省的格式字符串。

要返回格式化的 DATE 值，您必须指定下列引用字符串之一作为 ROUND 函数的第二个参数：

表 2. ROUND 函数的 DATE 参数的格式字符串
格式字符串	对返回的 DATE 值的影响
'`YEAR`'	四舍五入到最近一年之初。一月 30 日之后的日期舍入到下一年。month 和 day 值均舍入为 `01`。
'`MONTH`'	四舍五入到最近一月之初。15 日之后的日期舍入到下一月。返回的 day 值为 `01`。
'`DD`'	返回第一个 date_expression 参数的 DATE 值。
'`DAY`'	将该值舍入到最近的星期天。如果第一个参数为星期天，则返回那个日期。周三、周四、周五和周六的日期舍入到下一星期天。

当第一个参数为 DATE 数据类型时，如果您未指定格式字符串作为第二个参数，则缺省情况下没有格式字符串生效。不发出错误，但将第一个参数作为求值为整数的数值表达式来处理，而不作为 DATE 值。 GBase 8s 在内部将 DATE 值存储为从 1899 年 12 月 31 日以来的整数计数。对于 21 世纪中的日期，等同于 DATE 值的整数是 5 位整数，取值范围大约在 37,000 与 74,000 之间。

例如，查询 SELECT ROUND(TODAY) FROM systables 不为 DATE 表达式提供格式字符串，且如果在 2012 年 4 月 1 日发出该查询，则返回整数 40999。

如果您应用数值格式规范作为第二个参数，则非负的数值对 DATE 值不起作用，但下列示例将返回值的最后两个数字舍入为零：

SELECT ROUND(TODAY, -2) FROM systables;

在 2012 年 4 月 1 日，上述查询会返回整数值 40900。

在下一天，2012 年 4 月 2 日，同一查询会返回整数值 41000。

对于像 41000 这样的整数格式日期是有用的应用，您可使用 'YEAR'、'MONTH'、'DAY' 或 'DD' 格式字符串作为 ROUND 函数的第二个参数来防止将 DATE 参数处理成一个数值表达式。在 2012 年 4 月 1 日，下列查询返回 DATE 值 04/01/2012，如果 MDY4/ 是 DBDATE 环境变量设置的话：

SELECT ROUND(TODAY, 'DD') FROM systables WHERE tabid = 1;

在下列示例中，在 2012 年 4 月 3 日（星期二）发出一查询：

SELECT ROUND(TODAY, 'DAY') FROM mytab;

返回的值为 03/31/2012，当前的日期四舍五入到最近的星期天。

如果您正在使用主变量来在动态的 SQL 中存储四舍五入了的时间点值，且在准备时刻不知道第一个参数的数据类型，则 GBase 8s 假设 ROUND 函数的第一个参数是 DATETIME 数据类型，并返回 DATETIME YEAR TO MINUTE 四舍五入的值。在执行时刻，则准备该语句之后，如果为该主变量提供 DATE 值，则发出错误 -9750。要防止发生此错误，您可通过使用强制转型为主变量指定数据类型，如此程序片断中所示。

sprintf(query1, ", 
          "select round( ?::date, 'DAY') from mytab");
          EXEC SQL prepare selectq from :query;
          EXEC SQL declare select_cursor cursor for selectq;
          EXEC SQL open select_cursor using :hostvar_date_input;
          
          EXEC SQL fetch select_cursor into :var_date_output;

要了解可为内建的按时间顺序排列的数据类型指定显示和数据条目格式的 GBase 8s 环境变量之中的优先顺序，请参阅主题 DATE 和 DATETIME 格式规范的优先顺序。