ValueFormatter

Using a ValueFormatter, you can round values, specify a suffix, or format values as percentages.

Rounding¶

Here's how to round values to the nearest integer:

"valueFormatter": {
  "options": {
    "maximumFractionDigits": 0
  }
}

Currencies¶

Here's how to format values as dollars, with two decimal places:

"valueFormatter": {
  "options": {
    "style": "currency",
    "currency": "USD",
    "minimumFractionDigits": 2
  },
  "locale": "en-US"
}

Percentages¶

Here's how to format values as percentages, with one decimal place:

"valueFormatter": {
  "options": {
    "style": "percent",
    "minimumFractionDigits": 1
  }
}

Units¶

Here's how to format values with a unit, e.g. "100,000 users":

"valueFormatter": {
  "options": {
    "style": "unit",
    "unit": "user",
    "unitDisplay": "long"
  }
}

Locales¶

Locales are used to format values according to the locale of the user. For example, the locale en-US formats values as US dollars, while the locale en-GB formats values as British pounds. Leave the locale empty to use the default locale of the user's browser.

Style Options¶

Digit Options¶

Other Options¶