Number Formatting

The purpose of number formatting is to convert a Number object to a human readable string using the culture-specific settings.

The kendo.format and kendo.toString methods support standard and custom numeric formats.

Default Number Formats

  • "n"—Renders a number.

    kendo.culture("en-US"); kendo.toString(1234.567, "n"); //1,234.57

    kendo.toString(10.12, "n5"); //10.12000 kendo.toString(10.12, "n0"); //10

    kendo.culture("de-DE"); kendo.toString(1234.567, "n3"); //1.234,567

  • "c"—Renders a currency value.

    kendo.culture("en-US"); kendo.toString(1234.567, "c"); //$1,234.57

    kendo.culture("en-US"); kendo.toString(1234.567, "c0"); //$1,235

    kendo.culture("de-DE"); kendo.toString(1234.567, "c3"); //1.234,567 €

  • "p"—Renders a percentage (number is multiplied by 100).

    kendo.culture("en-US"); kendo.toString(0.222, "p"); //22.20 %

    kendo.culture("en-US"); kendo.toString(0.222, "p0"); //22 %

    kendo.culture("de-DE"); kendo.toString(0.22, "p3"); //22.000 %

  • "e"—Renders exponential values.

    kendo.toString(0.122, "e"); //1.22e-1 kendo.toString(0.122, "e4"); //1.2200e-1

Custom Number Formats

You can also create a custom numeric format string by using one or more custom numeric specifiers. A custom numeric format string is any string which is not a standard numeric format.

The following specifiers are supported by Kendo UI:

  • "0"—The zero placeholder replaces the zero with the corresponding digit if such is present. Otherwise, zero appears in the result string.

    kendo.toString(1234.5678, "00000") -> 01235

  • "#"—The digit placeholder replaces the pound sign with the corresponding digit if one is present. Otherwise, no digit appears in the result string. Cannot be used to format a number as a telephone number, that is, (###)-###-####.

    kendo.toString(1234.5678, "#####") -> 1235

  • "."—The decimal placeholder determines the location of the decimal separator in the result string.

    kendo.toString(0.45678, "0.00") -> 0.46 (en-US)

  • ","—The group separator placeholder inserts a localized group separator between each group.

    kendo.toString(12345678, "##,#") -> 12,345,678(en-US)

  • "%"—The percentage placeholder multiplies a number by 100 and inserts a localized percentage symbol in the result string. The % symbol is interpreted as a format specifier in the format string. To prevent this behavior, precede the % symbol with a double backslash - kendo.toString(12, "# \\\%") -> 12 % (en-US).

  • "$"—The currency placeholder specifies that the number will be formatted by using the currency culture settings. The $ symbol is replaced with the localized currency symbol. $ is interpreted as a format specifier in the format string. To prevent this behavior, precede the $ symbol with a double backslash - kendo.toString(12, "# \\\$") -> 12 $ (en-US).

  • "e"—The exponential notation.

    kendo.toString(0.45678, "e0") -> 5e-1

  • ";"—The section separator defines sections with separate format strings for positive, negative, and zero numbers.

  • "string"/'string'—The literal string delimiter indicates that the enclosed characters will be copied to the result string.

See Also

In this article
Not finding the help you need? Improve this article