DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

JavaScript/jQuery Number Box - Formatting

Use the format property to specify the integer, currency, accounting, percent, and other formats of the JavaScript NumberBox value.

Backend API
$(() => { $('#integer').dxNumberBox({ format: '#', value: 14500, inputAttr: { 'aria-label': 'Integer' }, }); $('#currency').dxNumberBox({ format: '$ #,##0.##', value: 14500.55, inputAttr: { 'aria-label': 'Currency Format' }, }); $('#accounting').dxNumberBox({ format: '$ #,##0.##;($ #,##0.##)', value: -2314.12, inputAttr: { 'aria-label': 'Accounting Format' }, }); $('#percent').dxNumberBox({ format: '#0%', value: 0.15, step: 0.01, inputAttr: { 'aria-label': 'Percent Format' }, }); $('#fixedPoint').dxNumberBox({ format: '#,##0.00', value: 13415.24, inputAttr: { 'aria-label': 'Fixed Point Format' }, }); $('#weight').dxNumberBox({ format: '#0.## kg', value: 3.14, inputAttr: { 'aria-label': 'Weight Format' }, }); });
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.7/css/dx.light.css" /> <script src="js/dx.all.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div class="dx-fieldset"> <div class="dx-field"> <div class="dx-field-label">Integer format</div> <div class="dx-field-value"> <div id="integer"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Currency format</div> <div class="dx-field-value"> <div id="currency"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Accounting format</div> <div class="dx-field-value"> <div id="accounting"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Percent format</div> <div class="dx-field-value"> <div id="percent"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Fixed point format</div> <div class="dx-field-value"> <div id="fixedPoint"></div> </div> </div> <div class="dx-field"> <div class="dx-field-label">Weight format</div> <div class="dx-field-value"> <div id="weight"></div> </div> </div> </div> </div> </body> </html>
.dx-field { margin-bottom: 20px; }

The format property can accept the following value types:

  • Predefined format
    See the type property description for a list of accepted values.

  • Custom format string
    Use a LDML pattern to specify a custom format. Refer to the following article for more information: Custom Format String.

  • Function
    A function should apply a custom format to a value and return the formatted value as a string. Functions are useful for advanced formatting.

  • Object
    Full format configuration. The object structure is shown in the format API section.