FORMAT_ROUND

説明

数値を"#,###,###.##"のような形式でフォーマットし、指定された小数点以下の桁数に丸めて、結果を文字列として返します。

ヒント

この関数はバージョン3.0.6以降でサポートされています。

構文

FORMAT_ROUND(<number>, <D>)

パラメータ

Parameter	デスクリプション
<number>	フォーマットする数値
<D>	小数点以下の桁数、範囲 [0, 1024]

Return Value

フォーマットされた文字列を返します。特殊なケース：

• パラメータがNULLの場合、NULLを返します
• Dが0の場合、結果には小数点や小数部分は含まれません。
• Dが[0, 1024]の範囲内でない場合、引数がこの範囲内である必要があることを示すエラーが返されます。

Examples

mysql> select format_round(17014116, 2);
+---------------------------+
| format_round(17014116, 2) |
+---------------------------+
| 17,014,116.00             |
+---------------------------+

mysql> select format_round(1123.456, 2);
+---------------------------+
| format_round(1123.456, 2) |
+---------------------------+
| 1,123.46                  |
+---------------------------+

mysql> select format_round(1123.4, 2);
+-------------------------+
| format_round(1123.4, 2) |
+-------------------------+
| 1,123.40                |
+-------------------------+

mysql> select format_round(123456, 0);
+-------------------------+
| format_round(123456, 0) |
+-------------------------+
| 123,456                 |
+-------------------------+

mysql> select format_round(123456, 3);
+-------------------------+
| format_round(123456, 3) |
+-------------------------+
| 123,456.000             |
+-------------------------+

mysql> select format_round(123456.123456, 0);
+--------------------------------+
| format_round(123456.123456, 0) |
+--------------------------------+
| 123,456                        |
+--------------------------------+

mysql> select format_round(123456.123456, 3);
+--------------------------------+
| format_round(123456.123456, 3) |
+--------------------------------+
| 123,456.123                    |
+--------------------------------+

mysql> select format_round(123456.123456, 6);
+--------------------------------+
| format_round(123456.123456, 6) |
+--------------------------------+
| 123,456.123456                 |
+--------------------------------+

mysql> SELECT format_round(-0.01, -1);
ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]The second argument is -1, it should be in range [0, 1024].
mysql> SELECT format_round(-0.01, -1500);
ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]The second argument is -1500, it should be in range [0, 1024].