FORMAT_NUMBER为MaxCompute 2.0扩展函数,用于格式化数字,使其按照指定的格式显示,通常包括千位分隔符、小数点后的位数等。本文为您介绍FORMAT_NUMBER的命令格式、参数说明以及使用示例。
命令格式
string format_number(float|double|decimal <expr1>, <expr2>)
参数说明
expr1:必填。需要格式化的数据。DOUBLE、BIGINT、INT、SMALLINT、TINYINT、FLOAT、DECIMAL、STRING类型。
expr2:必填。需要转化的目标格式。指定需要保留小数位数。也可以为类似
#,###,###.##
格式描述。
返回值说明
返回STRING类型数据。返回规则如下:
如果expr2>0,则四舍五入到小数点后指定位数。
如果expr2=0,则没有小数点或小数部分。
如果expr2<0,或者expr2>340,则返回报错。
expr1或expr2值为NULL时,返回NULL。
示例数据
为便于理解各函数的使用方法,本文为您提供源数据,基于源数据提供函数相关示例。创建表mf_math_fun_t,并添加数据,命令示例如下。
create table if not exists mf_math_fun_t(
int_data int,
bigint_data bigint,
double_data double,
decimal_data decimal,
float_data float,
string_data string
);
insert into mf_math_fun_t values
(null, -10, 0.525, 0.525BD, cast(0.525 as float), '10'),
(-20, null, -0.1, -0.1BD, cast(-0.1 as float), '-10'),
(0, -1, null, 20.45BD, cast(-1 as float), '30'),
(-40, 4, 0.89, null, cast(0.89 as float), '-30'),
(5, -50, -1, -1BD, null, '50'),
(-60, 6, 1.5, 1.5BD, cast(1.5 as float), '-50'),
(-1, -70, -7.5, -7.5BD, cast(-7.5 as float),null ),
(-80, 1, -10.2, -10.2BD, cast(-10.2 as float), '-1' ),
(9, -90, 2.58, 2.58BD, cast(2.58 as float), '0'),
(-100, 10, -5.8, -5.8BD, cast(-5.8 as float), '-90');
查询表mf_math_fun_t中的数据,命令示例如下:
select * from mf_math_fun_t;
--返回结果。
+------------+-------------+-------------+--------------+------------+-------------+
| int_data | bigint_data | double_data | decimal_data | float_data | string_data |
+------------+-------------+-------------+--------------+------------+-------------+
| NULL | -10 | 0.525 | 0.525 | 0.525 | 10 |
| -20 | NULL | -0.1 | -0.1 | -0.1 | -10 |
| 0 | -1 | NULL | 20.45 | -1.0 | 30 |
| -40 | 4 | 0.89 | NULL | 0.89 | -30 |
| 5 | -50 | -1.0 | -1 | NULL | 50 |
| -60 | 6 | 1.5 | 1.5 | 1.5 | -50 |
| -1 | -70 | -7.5 | -7.5 | -7.5 | NULL |
| -80 | 1 | -10.2 | -10.2 | -10.2 | -1 |
| 9 | -90 | 2.58 | 2.58 | 2.58 | 0 |
| -100 | 10 | -5.8 | -5.8 | -5.8 | -90 |
+------------+-------------+-------------+--------------+------------+-------------+
使用示例:静态数据示例
--返回5.230。
select format_number(5.230134523424545456,3);
--返回12,332.123。
select format_number(12332.123456, '#,###,###,###.###');
--返回NULL。
select format_number(null,3);
使用示例:表数据示例
基于示例数据,将所有列保留指定小数位数,命令示例如下。
--开启2.0新类型。此命令需要与SQL语句一起提交。
set odps.sql.type.system.odps2=true;
select format_number(int_data, 1) as int_new, format_number(bigint_data, 1) as bigint_new, format_number(double_data, 2) as double_new, format_number(decimal_data, 1) as decimal_new, format_number(float_data, 0) as float_new, format_number(string_data, 1) as string_new from mf_math_fun_t;
返回结果如下。
+---------+------------+------------+-------------+-----------+------------+
| int_new | bigint_new | double_new | decimal_new | float_new | string_new |
+---------+------------+------------+-------------+-----------+------------+
| NULL | -10.0 | 0.53 | 0.5 | 1 | 10.0 |
| -20.0 | NULL | -0.10 | -0.1 | -0 | -10.0 |
| 0.0 | -1.0 | NULL | 20.5 | -1 | 30.0 |
| -40.0 | 4.0 | 0.89 | NULL | 1 | -30.0 |
| 5.0 | -50.0 | -1.00 | -1.0 | NULL | 50.0 |
| -60.0 | 6.0 | 1.50 | 1.5 | 2 | -50.0 |
| -1.0 | -70.0 | -7.50 | -7.5 | -8 | NULL |
| -80.0 | 1.0 | -10.20 | -10.2 | -10 | -1.0 |
| 9.0 | -90.0 | 2.58 | 2.6 | 3 | 0.0 |
| -100.0 | 10.0 | -5.80 | -5.8 | -6 | -90.0 |
+---------+------------+------------+-------------+-----------+------------+
相关函数
FORMAT_NUMBER函数属于数学函数或字符串函数。