Numeral Formatting

Numeral formatting in Kibana is done through a pattern-based syntax. These patterns express common number formats in a concise way, similar to date formatting. While these patterns are originally based on Numeral.js, they are now maintained by Kibana.

Numeral formatting patterns are used in multiple places in Kibana, including:

The simplest pattern format is 0, and the default Kibana pattern is 0,0.[000]. The numeral pattern syntax expresses:

The display of these patterns is affected by the advanced setting format:number:defaultLocale. The default locale is en, but some examples will specify that they are using an alternate locale.

Most basic examples:

By adding the % symbol to any of the previous patterns, the value is multiplied by 100 and the % symbol is added in the place indicated.

The default percentage formatter in Kibana is 0,0.[000]%, which shows up to three decimal places.

The bytes and bits formatters will shorten the input by adding a suffix like GB or TB. Bytes and bits formatters include the following suffixes:

Suffixes are not localized with this formatter.

Currency formatting is limited in Kibana due to the limitations of the pattern syntax. To enable currency formatting, use the symbol $ in the pattern syntax. The number formatting locale will affect the result.

Converts a value in seconds to display hours, minutes, and seconds.

The a pattern will look for the shortest abbreviation for your number, and use a locale-specific display for it. The abbreviations aK, aM, aB, and aT can indicate that the number should be abbreviated to a specific order of magnitude.

The o pattern will display a locale-specific positional value like 1st or 2nd. This pattern has limited support for localization, especially in languages with multiple forms, such as German.

These number formats, combined with the previously described patterns, produce the complete set of options for numeral formatting. The output here is all for the en locale.