# 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`](https://www.telerik.com/kendo-jquery-ui/documentation/api/kendo#format) and [`kendo.toString`](https://www.telerik.com/kendo-jquery-ui/documentation/api/kendo#tostring) methods support standard and custom numeric formats.

The following runnable example demonstrates how to format numbers by using the [`kendo.toString`](https://www.telerik.com/kendo-jquery-ui/documentation/api/kendo/methods/tostring) method:

```dojo
    
    <script src="https://cdn.jsdelivr.net/npm/@progress/kendo-ui@2026.4.1111/js/cultures/kendo.culture.de-DE.min.js"></script>
    <h4>Number formats with US culture.</h4>
    <div id="content"></div>
    <h4>Number formats with DE culture.</h4>
    <div id="content2"></div>
    <h4>Applying Number formatting to Grid columns.</h4>
    <div id="grid"></div>
    <script>
      // Default culture is en-US.
      let number = 1234.567
      let format = "<p> Format 'n' = " + kendo.toString(number, "n") + "</p>"
      +"<p> Format 'c' = " + kendo.toString(number, "c") + "</p>"     
      +"<p> Format 'p' = " + kendo.toString(number, "p") + "</p>"
      +"<p> Format 'e' = " + kendo.toString(number, "e") + "</p>"

      +"<p> Custom format 'n3' = " + kendo.toString(number, "n3") + "</p>"
      +"<p> Custom format 'c3' = " + kendo.toString(number, "c3") + "</p>"
      +"<p> Custom format 'p0' = " + kendo.toString(number, "p0") + "</p>"
      +"<p> Custom format 'p2' = " + kendo.toString(number, "p2") + "</p>"
      +"<p> Custom format '#' = " + kendo.toString(number, "#") + "</p>"
      +"<p> Fromat decimal placeholder '.' = " + kendo.toString(number, "0.00") + "</p>"
      +"<p> Fromat group separator ',' = " + kendo.toString(number, "##,#") + "</p>"
      +"<p> Percentage placeholder '%' = " + kendo.toString(number, "# \\%") + "</p>"
      +"<p> Currency placeholder '$' = " + kendo.toString(number, "# \\$") + "</p>"
      +"<p> The exponential notation 'e0' = " + kendo.toString(number, "e0") + "</p><hr>";
      $(format).appendTo(content);

      // Switch to DE culture.
      kendo.culture("de-DE");

      let format2 =  "<p> Format 'c' = " + kendo.toString(number, "c") + "</p>"     
      +"<p> Format 'p' = " + kendo.toString(number, "p") + "</p>"
      +"<p> Custom format 'n3' = " + kendo.toString(number, "n3") + "</p>"
      +"<p> Custom format 'c3' = " + kendo.toString(number, "c3") + "</p>"
      +"<p> Custom format 'p0' = " + kendo.toString(number, "p0") + "</p>"
      +"<p> Custom format 'p2' = " + kendo.toString(number, "p2") + "</p>"
      +"<p> Fromat decimal placeholder '.' = " + kendo.toString(number, "0.00") + "</p>"
      +"<p> Fromat group separator ',' = " + kendo.toString(number, "##,#") + "</p>"
      +"<p> Currency placeholder '$' = " + kendo.toString(number, "# \\$") + "</p><hr>";

      $(format2).appendTo(content2);

      $("#grid").kendoGrid({
        dataSource: [
          {
            number: 123.456, 
          }
        ],
        columns: [{
          title: "n3",
          field: "number",
          format: "{0:n3}"
        },{
          title: "p0",
          field: "number",
          format: "{0:p0}"
        },{
          title: "c2",
          field: "number",
          format: "{0:c2}"
        },{
          title: "Decimal placeholder",
          field: "number",
          format: "{0:0.00}"
        },{
          title: "Standard",
          field: "number"
        }]
      });
    </script>
```

## 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.

The following runnable example demonstrates how to use the [`kendo.toString`](https://www.telerik.com/kendo-jquery-ui/documentation/api/kendo/methods/tostring) method in the [`eventTemplate`](https://www.telerik.com/kendo-jquery-ui/documentation/api/ui/scheduler/configuration/eventtemplate) of the Scheduler:

```dojo
    <div>
      <label for="language">Choose language:</label>
      <input id="language" value="en-US" />
    </div>

    <div id="scheduler"></div>
    <script id="event-template" type="text/x-kendo-template">
      <div> Title: #: title #</div>
      <div> Cost: #: kendo.toString(number, 'c0', kendo.culture().name) #</div>
    </script>
    <script>

      function changeLanguage() {
        kendo.ui.progress($("#scheduler"), true);
        language= this.value();

        var baseUrlMessages = 'https://cdn.jsdelivr.net/npm/@progress/kendo-ui@2026.4.1111/js/messages/kendo.messages.';
        var baseUrlCultures = 'https://cdn.jsdelivr.net/npm/@progress/kendo-ui@2026.4.1111/js/cultures/kendo.culture.';

        $.getScript(baseUrlMessages + language + ".min.js", function () {
          $.getScript(baseUrlCultures + language + ".min.js", function () {
            kendo.culture(language);
            kendo.ui.progress($("#scheduler"), false);
            createScheduler();
          });
        });
      }

      $(document).ready(function() {
        $("#language").kendoDropDownList({
          change: changeLanguage,
          dataTextField: "text",
          dataValueField: "value",
          dataSource: [
            {text: "bg-BG"},
            {text: "zh-CN"},
            {text: "de-DE"},
            {text: "en-US"},
          ]
        });

        $("#language").data("kendoDropDownList").trigger("change");
      });

      function createScheduler() {
        var element = $("#scheduler");

        if (element.data("kendoScheduler")) {
          element.data("kendoScheduler").destroy();
          element.empty();
        }

        element.kendoScheduler({
          date: new Date("11/02/2022"),
          startTime: new Date("2022/11/02 08:00 AM"),
          editable: false,
          eventTemplate: $("#event-template").html(),  
          height: 500,
          views: ["day", "week"],
          dataSource: [
            {
              id: 1,
              start: new Date("2022/11/02 08:00 AM"),
              end: new Date("2022/11/02 09:00 AM"),
              title: "Auto Exhibition",
              number: 50000
            }
          ]  
        });
      }
    </script>
```

## See Also

* [Overview of Globalization in Kendo UI](https://www.telerik.com/kendo-jquery-ui/documentation/globalization/overview)
* [Culture Definition](https://www.telerik.com/kendo-jquery-ui/documentation/globalization/intl/definecultureinfo)
* [Date Formatting](https://www.telerik.com/kendo-jquery-ui/documentation/globalization/intl/dateformatting)
* [Date Parsing](https://www.telerik.com/kendo-jquery-ui/documentation/globalization/intl/dateparsing)
* [Number Parsing](https://www.telerik.com/kendo-jquery-ui/documentation/globalization/intl/numberparsing)
