The N/format/i18n module extends N/format with locale-specific formatting β formatting numbers, dates, and currencies according to a particular region’s conventions rather than the current user’s preferences.
Formatting by Locale
define(["N/format/i18n", "N/log"], (i18n, log) => {
const formatter = i18n.getNumberFormatter({ locale: i18n.Locale.en_US });
const formatted = formatter.format({ number: 1234567.89 });
log.debug("US format", formatted); // 1,234,567.89
const deFormatter = i18n.getNumberFormatter({ locale: i18n.Locale.de_DE });
const deFormatted = deFormatter.format({ number: 1234567.89 });
log.debug("DE format", deFormatted); // 1.234.567,89
return {};
});Key Methods
| Method | Description |
|---|---|
i18n.getNumberFormatter(options) | Get a locale-specific number formatter |
i18n.getCurrencyFormatter(options) | Get a locale-specific currency formatter |
i18n.getDateTimeFormatter(options) | Get a locale-specific date/time formatter |
formatter.format(options) | Format a value using the locale formatter |