指定された小数点以下の桁に丸めた数値を返します。
構文
double|decimal round(<number>[, bigint <decimal_places>])パラメーター
number: 必須です。 DOUBLEまたはDECIMAL型の値。 入力値がSTRING型またはBIGINT型の場合は、計算前に暗黙的にDOUBLE型の値に変換されます。
decimal_places: オプション。 BIGINT型の定数。 このパラメータは、数値を四捨五入する小数点以下の桁を指定します。 このパラメーターが指定されていない場合、数値は1つの場所に丸められます。 デフォルト値は0です。
説明deciment_placesの値は負にすることができます。 負の値は、小数点から左にカウントすることを示し、小数部は除外される。 deciment_placesの値が整数部分の長さを超える場合、0が返されます。
戻り値
DOUBLEまたはDECIMAL型の値が返されます。 戻り値は、次のルールによって異なります。
numberの値がDOUBLE型またはDECIMAL型の場合、同じ型の値が返されます。
numberの値がSTRING型またはBIGINT型の場合、DOUBLE型の値が返されます。
deciment_placesの値がBIGINT型でない場合、エラーが返されます。
numberまたはdeciment_placesの値が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;
-- The following result is returned:
+------------+-------------+-------------+--------------+------------+-------------+
| 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 |
+------------+-------------+-------------+--------------+------------+-------------+例: 静的データ
-- The value 125.0 is returned.
select round(125.315);
-- The value 125.3 is returned.
select round(125.315, 1);
-- The value 125.32 is returned.
select round(125.315, 2);
-- The value 125.315 is returned.
select round(125.315, 3);
-- The value -125.32 is returned.
select round(-125.315, 2);
-- The value 100.0 is returned.
select round(123.345, -2);
-- The value null is returned.
select round(null);
-- The value 123.345 is returned.
select round(123.345, 4);
-- The value 0.0 is returned.
select round(123.345, -4);例: テーブルデータ
サンプルデータに基づいて、列内で指定した小数点以下の桁に丸められた数値を返します。 サンプル文:
select round(bigint_data, 1) as bigint_new, round(double_data, 2) as double_new, round(decimal_data, 1) as decimal_new, round(string_data) as string_new from mf_math_fun_t;次の結果が返されます。
+------------+------------+-------------+------------+
| bigint_new | double_new | decimal_new | string_new |
+------------+------------+-------------+------------+
| -10.0 | 0.53 | 0.5 | 10.0 |
| NULL | -0.1 | -0.1 | -10.0 |
| -1.0 | NULL | 20.5 | 30.0 |
| 4.0 | 0.89 | NULL | -30.0 |
| -50.0 | -1.0 | -1 | 50.0 |
| 6.0 | 1.5 | 1.5 | -50.0 |
| -70.0 | -7.5 | -7.5 | NULL |
| 1.0 | -10.2 | -10.2 | -1.0 |
| -90.0 | 2.58 | 2.6 | 0.0 |
| 10.0 | -5.8 | -5.8 | -90.0 |
+------------+------------+-------------+------------+関連関数
ROUNDは数学関数です。 データコンピューティングと変換に関連する関数の詳細については、数学関数.