The FORMAT SQL Function in MySQL and MariaDB - Format numbers |
|
| | FORMAT | Syntax: | FORMAT(Number, Decimals [, Region]) | | Return value: | CHAR | | Function type: | String function | |
| | The FORMAT() function formats "Number" into a string, adding separators and rounding to "Decimals".
If the specified "Decimals" is 0, it will be rounded to a integer number.
Optionally, a locale value can be specified in "Region" to format according to the pattern for the respective region.
If "Number" or "Decimals" are strings, they are interpreted as numbers.
If "Decimals" is an empty or invalid string, it is interpreted as 0.
The maximum value for "Decimals" is 32, larger values produce 32 decimals.
If the value of "Number" or "Decimals" is NULL, the function returns NULL. | SQL Examples for the FORMAT function |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
| SELECT format(12345.6789, 3);
SELECT format('12345.6789', 3);
SELECT format(12345.6789, 10);
SELECT format('12345.6789', '10');
SELECT format(12345.6789, 0);
SELECT format(12345.6789, '');
SELECT format(12345.6789, 100);
SELECT format(12345.6789, 32);
SELECT format(123456789, 2, 'en_GB');
SELECT format(123456789, 2, 'ja_JP');
SELECT format(null, 0);
SELECT format(12345, null);
|
|
| format(12345.6789, 3) |
|---|
| varchar(46) BINARY |
|---|
| 12,345.679 |
|
|
| format('12345.6789', 3) |
|---|
| varchar(45) BINARY |
|---|
| 12,345.679 |
|
|
| format(12345.6789, 10) |
|---|
| varchar(46) BINARY |
|---|
| 12,345.6789000000 |
|
|
| format('12345.6789', '10') |
|---|
| varchar(45) BINARY |
|---|
| 12,345.6789000000 |
|
|
| format(12345.6789, 0) |
|---|
| varchar(46) BINARY |
|---|
| 12,346 |
|
|
| format(12345.6789, '') |
|---|
| varchar(46) BINARY |
|---|
| 12,346 |
|
|
| format(12345.6789, 100) |
|---|
| varchar(46) BINARY |
|---|
| 12,345.678900000000000000000000000000 |
|
|
| format(12345.6789, 32) |
|---|
| varchar(46) BINARY |
|---|
| 12,345.678900000000000000000000000000 |
|
|
| format(123456789, 2, 'en_GB') |
|---|
| varchar(44) BINARY |
|---|
| 123,456,789.00 |
|
|
| format(123456789, 2, 'ja_JP') |
|---|
| varchar(44) BINARY |
|---|
| 123,456,789.00 |
|
|
| format(null, 0) |
|---|
| varchar(32) BINARY |
|---|
| NULL |
|
|
| format(12345, null) |
|---|
| varchar(38) BINARY |
|---|
| NULL |
|
|
| | The examples were created with the MyWAY SQL manager: | How to use the FORMAT() function in MySQL and MariaDB databases | | The FORMAT() function in MySQL and MariaDB can be used to convert a numeric value with a specified number of decimal places, using commas as the thousands separator. This makes numeric values more readable. The function returns a string, not a numeric value. The FORMAT() function is very useful when you want to present numeric values in a more readable format, for example for displaying financial data, quantities or statistics from queries from the database. | | Further MySQL und MariaDB SQL String functions | | CHAR | CHAR(Character code, [, Charset]) | | More about CHAR Function |
| | CHR | CHR(Character code) | | More about CHR Function |
| | CONCAT | CONCAT(Strings ('str1','str2', ...)) | | More about CONCAT Function |
| | CONCAT_WS | CONCAT_WS(Separator, Strings ('str1','str2', ...)) | | More about CONCAT_WS Function |
| | ELT | ELT(Index, Strings ('str1','str2', ...)) | | More about ELT Function |
| | EXPORT_SET | EXPORT_SET(Bits, On, Off [, Separator] [, Number of bits]) | | More about EXPORT_SET Function |
| | EXTRACTVALUE | EXTRACTVALUE(XML, XPath) |
| | FIELD | FIELD(Search string, Strings ('str1','str2', ...)) | | More about FIELD Function |
| | INSERT | INSERT(String, Position, Length, String to insert) | | More about INSERT Function |
| | LCASE | LCASE(String) | | More about LCASE Function |
| | LEFT | LEFT(String, Length) | | More about LEFT Function |
| | LOAD_FILE | LOAD_FILE(File name) |
| | LOWER | LOWER(String) | | More about LOWER Function |
| | LPAD | LPAD(String, Length, String to append) | | More about LPAD Function |
| | LPAD_ORACLE | LPAD_ORACLE(String, Length, String to append) | | More about LPAD_ORACLE Function |
| | LTRIM | LTRIM(String) | | More about LTRIM Function |
| | MAKE_SET | MAKE_SET(Bits, Strings ('str1','str2', ...)) | | More about MAKE_SET Function |
| | MID | MID(String, Position [, Length]) | | More about MID Function |
| | QUOTE | QUOTE(String) | | More about QUOTE Function |
| | REPEAT | REPEAT(String, Number) | | More about REPEAT Function |
| | REPLACE | REPLACE(String, Search, Replace) | | More about REPLACE Function |
| | REVERSE | REVERSE(String) | | More about REVERSE Function |
| | RIGHT | RIGHT(String, Length) | | More about RIGHT Function |
| | RPAD | RPAD(String, Length, String to append) | | More about RPAD Function |
| | RPAD_ORACLE | RPAD_ORACLE(String, Length, String to append) | | More about RPAD_ORACLE Function |
| | RTRIM | RTRIM(String) | | More about RTRIM Function |
| | SOUNDEX | SOUNDEX(String) | | More about SOUNDEX Function |
| | SPACE | SPACE(Number) | | More about SPACE Function |
| | SUBSTR | SUBSTR(String, Position, Length) | | More about SUBSTR Function |
| | SUBSTRING | SUBSTRING(String, Position, Length) | | More about SUBSTRING Function |
| | SUBSTRING_INDEX | SUBSTRING_INDEX(String, Delimiter, Number) | | More about SUBSTRING_INDEX Function |
| | TRIM | TRIM([Type] [, Delete character], , String) | | More about TRIM Function |
| | TRIM_ORACLE | TRIM_ORACLE([Type] [, Delete character], , String) | | More about TRIM_ORACLE Function |
| | UCASE | UCASE(String) | | More about UCASE Function |
| | UPPER | UPPER(String) | | More about UPPER Function |
| | WEIGHT_STRING | WEIGHT_STRING(String [AS Format] [LEVEL Level] [Sorting]) | | More about WEIGHT_STRING Function |
| | ASCII | ASCII(String) | | More about ASCII Function |
| | BIT_LENGTH | BIT_LENGTH(String) | | More about BIT_LENGTH Function |
| | CHAR_LENGTH | CHAR_LENGTH(String) | | More about CHAR_LENGTH Function |
| | CHARACTER_LENGTH | CHARACTER_LENGTH(String) | | More about CHARACTER_LENGTH Function |
| | FIND_IN_SET | FIND_IN_SET(Search string, Set of values) | | More about FIND_IN_SET Function |
| | INSTR | INSTR(String, Search string) | | More about INSTR Function |
| | LENGTH | LENGTH(String) | | More about LENGTH Function |
| | LENGTHB | LENGTHB(String) | | More about LENGTHB Function |
| | LOCATE | LOCATE(Search string, String [, Position]) | | More about LOCATE Function |
| | OCTET_LENGTH | OCTET_LENGTH(String) | | More about OCTET_LENGTH Function |
| | ORD | ORD(String) | | More about ORD Function |
| | POSITION | POSITION(Search string IN String) | | More about POSITION Function |
|
|
| | | More information about the FORMAT SQL function: and and |
|
|
|
|
