Skip to main content
The renderer turns raw values into display text — numbers, dates and currencies — locale-aware. The engine emits raw values; formatting happens here, at paint time.

​
Two locales

Two locales are in play:
  • Parsing locale — how ambiguous input is interpreted (is 01/02/2024 Jan 2 or Feb 1?). Set on the data via data._metadata.parsingLocale; defaults to en-GB.
  • Formatting locale — how output is displayed (separators, month names, currency symbols). Set with the formattingLocale prop on GraphProvider.
When you don’t set formattingLocale, display falls back to the parsing locale.

​
Supported locales

en-GB, en-US, ar, pt-PT.

​
Number formatting

Locale governs separators and symbols; the numberFormat config governs the rest — decimals, abbreviation, and any prefix/suffix — and can override the locale’s separators when you need to:

​
Currencies and dates

Currency and date columns detected during value-format inference are formatted for the active locale automatically — a £1,250 column renders with the right symbol and grouping, a date axis with locale-appropriate month names — without extra configuration.

​
Related