在 MariaDB 中格式化数字(FORMAT 函数详解)

详细介绍在 MariaDB 中使用 FORMAT() 函数对数字进行千分位分隔、保留指定小数位及基于区域语言环境(Locale)进行本地化数字格式化的用法与实战示例。

发布于

在财务结算、报表输出或面向用户的展示界面中,直接显示原始浮点数(如 1234567.8912)往往不够直观。通常需要将数值添加千分位逗号分隔符,并将小数位四舍五入保留到指定长度(如 1,234,567.89)。

在 MariaDB 中,内置的 FORMAT() 函数专门用于完成这一任务。


FORMAT() 语法与参数

FORMAT(X, D[, locale])

参数解析

  • X:待格式化的原始数值(整数、浮点数或数值型字符串)。
  • D:指定保留的小数位数。若数值的小数位超出 D,将执行四舍五入;若不足 D,将自动在末尾补零填充;若设为 0,则返回没有小数部分的整数形式。
  • locale:可选参数。指定格式化所遵循的区域语言环境代码(如 'en_US'、'zh_CN'、'de_DE')。省略时,默认使用当前系统的区域设置。

[!NOTE] FORMAT() 函数的返回值类型为字符串(VARCHAR),而不是数值类型。因此,格式化应放在 SQL 查询的最外层展示阶段,避免在格式化后的结果上继续进行数学加减运算。


示例 1:指定小数位数与补零规则

下面的示例将数值 1234.56789 格式化并保留 4 位小数(第 5 位小数 9 会触发四舍五入):

SELECT FORMAT(1234.56789, 4);

输出:

+-----------------------+
| FORMAT(1234.56789, 4) |
+-----------------------+
| 1,234.5679            |
+-----------------------+

当指定不同的小数位数时,表现如下:

SELECT
  FORMAT(1234.56, 0) AS "round_int",
  FORMAT(1234.56, 3) AS "pad_zero_3",
  FORMAT(1234.56, 5) AS "pad_zero_5";

输出:

+-----------+------------+-------------+
| round_int | pad_zero_3 | pad_zero_5  |
+-----------+------------+-------------+
| 1,235     | 1,234.560  | 1,234.56000 |
+-----------+------------+-------------+
  • 当 D = 0 时,1234.56 被四舍五入为整数 1,235。
  • 当 D = 3 或 5 时,由于原数值只有 2 位小数,不足部分在末尾自动补 0。

示例 2:利用 Locale 参数实现本地化格式

不同国家和地区的数字千分位与小数点符号书写规范有所不同:

  • 中国(zh_CN)与美国(en_US):逗号 , 为千位分隔符,点 . 为小数点(如 12,345.68)。
  • 德国(de_DE)与部分欧洲国家:点 . 为千位分隔符,逗号 , 为小数点(如 12.345,68)。

通过传入第三个参数 locale,可以轻松满足跨国业务系统的本地化格式需求:

SELECT
  FORMAT(12345.678, 2, 'de_DE') AS "de_DE",
  FORMAT(12345.678, 2, 'zh_CN') AS "zh_CN";

输出:

+-----------+-----------+
| de_DE     | zh_CN     |
+-----------+-----------+
| 12.345,68 | 12,345.68 |
+-----------+-----------+

[!TIP] 要查看 MariaDB 支持的全部区域语言代码(Locale),请参考在 MariaDB 中显示所有区域设置。


总结

  • 在 MariaDB 中展示数字,推荐使用 FORMAT(X, D) 自动处理千分位分割与定长小数四舍五入。
  • 涉外多语言系统可通过第三个参数 locale 定制德系、西系或中英系的本地化数字格式。