d3plus-format

d3plus-format

Shorthand formatters for common number types.

Installing

If you use NPM, run npm install d3plus-format --save. Otherwise, download the latest release. The released bundle supports AMD, CommonJS, and vanilla environments. You can also load directly from d3plus.org:

<script src="https://d3plus.org/js/d3plus-format.v0.1.full.min.js"></script>

API Reference

• formatAbbreviate - Formats a number to an appropriate number of decimal places and rounding, adding suffixes if applicable (ie. 1200000 to "1.2M").
• formatAbbreviate - An extension to d3's format function that adds more string formatting types and localizations.

The new specifier strings added by d3plus-format are:

• .3~a - abbreviated decimal notation with a numeric suffix (ie. "k", "M", "B", etc). This is an alias of the formatAbbreviate function.

• formatDefaultLocale - An extension to d3's formatDefaultLocale function that allows setting the locale globally for formatters.

• formatLocale - A set of default locale formatters used when assigning suffixes and currency in numbers.

Name	Default	Description
separator	""	Separation between the number with the suffix.
suffixes	[]	List of suffixes used to format numbers.
grouping	[3]	The array of group sizes,
delimiters	{thousands: ",", decimal: "."}	Decimal and group separators.
currency	["$", ""]	The currency prefix and suffix.

---

d3plus.formatAbbreviate(n, locale) <>

Formats a number to an appropriate number of decimal places and rounding, adding suffixes if applicable (ie. 1200000 to "1.2M").

This is a global function.

Param	Type	Description
n	Number | String	The number to be formatted.
locale	Object | String	The locale config to be used. If value is an object, the function will format the numbers according the object. The object must include suffixes, delimiter and currency properties.

---

d3plus.formatAbbreviate(specifier) <>

An extension to d3's format function that adds more string formatting types and localizations.

The new specifier strings added by d3plus-format are:

• .3~a - abbreviated decimal notation with a numeric suffix (ie. "k", "M", "B", etc). This is an alias of the formatAbbreviate function.

This is a global function.

---

d3plus.formatDefaultLocale(definition) <>

An extension to d3's formatDefaultLocale function that allows setting the locale globally for formatters.

This is a global function.

---

formatLocale <>

A set of default locale formatters used when assigning suffixes and currency in numbers.

Name	Default	Description
separator	""	Separation between the number with the suffix.
suffixes	[]	List of suffixes used to format numbers.
grouping	[3]	The array of group sizes,
delimiters	{thousands: ",", decimal: "."}	Decimal and group separators.
currency	["$", ""]	The currency prefix and suffix.

This is a global namespace.

---

_{Documentation generated on Tue, 22 Dec 2020 15:36:19 GMT}