NumberFormatter - Scoped, Global

The NumberFormatter API includes methods that return numbers formatted according to the language of the current user.

This API is available in scoped and global apps and runs in the sn_i18n namespace.

When formatted by language or locale, users can view numbers as expected. For example, if the locale is fr (French), a value provided as 100.00 returns as 100,00.

Parent Topic:Server API reference

NumberFormatter – format(Number number)

Returns a string representation of a number formatted according to the language setting of the current user.

Name	Type	Description
number	Number	Number of any size.

Type	Description
String	Number formatted according to the language setting of the current user.

The following example shows the return results for a user with their language set to Spanish.

gs.info("Number is: " + sn_i18n.NumberFormatter.format(123456.789));
gs.info("Number is: " + sn_i18n.NumberFormatter.format(-123456.789));

Output:

Number is: 123.456,789
Number is: -123.456,789

NumberFormatter – formatLang(Number number, String language)

Returns a string representation of a number formatted according to the language passed as a parameter.

Name	Type	Description
number	Number	Number of any size.
language	String	Language tag conforming with IETF BCP-47.

Type	Description
String	Number formatted according to the language passed as a parameter.

The following example shows output for German language setting.

gs.info("Number is: " + sn_i18n.NumberFormatter.formatLang(123456.789, "de-de"));
gs.info("Number is: " + sn_i18n.NumberFormatter.formatLang(-123456.789, "de-de"));

Output:

Number is: 123.456,789
Number is: -123.456,789

NumberFormatter - parseWithLocale(String number, String language, String country)

Parses a number from a passed text string, traversing left-to-right, to extract the numeric value. It then uses the passed country and language codes to identify the locale of the number and returns the parsed number in that format.

This method parses the string until it reaches a character that it doesn't recognize as a numeric value or a currency separator.

Name	Type	Description
number	String	String to parse. This string can contain numeric values and currency separators such as commas and decimal points. For example: `"24,506.55"` or `"45.677,89"`.
language	String	Two-character ISO-639 language code.
country	String	Two-character ISO-3166 country code.

Type

Description

Number

Parsed number in the specified locale's format. Throws an exception if the first character of the string can't be parsed. For example: - "123.34": Parses to 123.34 as long as the locale decimal separator is a period. - "1,234.56": Parses to 1234.56 as long as the locale grouping separator is a comma and the decimal separator is a period. - "1.234.567,89": If the grouping separator is anything but a period, parses to 1. - "123x456": Parses to 123. - "text123": Causes the method to throw a ParseException.

The following code example demonstrates parsing strings for various locales, as well as parsing a string with unexpected separators. The last example only partially parses the string because a space isn't a valid separator.

var x = sn_i18n.NumberFormatter.parseWithLocale("48,837.77", "en", "US");
var y =  sn_i18n.NumberFormatter.parseWithLocale("77.931,22", "de", "DE");
var z = sn_i18n.NumberFormatter.parseWithLocale("562 339,89", "fr", "FR");
var specialCase = sn_i18n.NumberFormatter.parseWithLocale("400 797,67", "en", "US");

gs.info(x);
gs.info(y);
gs.info(z);
gs.info(specialCase);

Output:

NumberFormatter - parseWithSeparators(String number, String groupingSeparator, String decimalSeparator)

Parses and returns a number from a passed text string, traversing left-to-right, until it encounters a character that it can't parse. Parsable values include numbers and the specified grouping and decimal separators.

Name	Type	Description
number	String	String to parse. This string can contain numeric values and the specified separators such as commas and decimal points. For example: `"24,506.55"` or `"45.677,89"`.
groupingSeparator	String	Character that denotes the grouping separator, also known as the thousands separator, within the passed string. For example: Comma ",", period ".", or space " ".
decimalSeparator	String	Character that denotes the decimal separator within the passed string.For example: Comma ",", period ".", or space " ".

Type

Description

Number

Parsed number. Throws an exception if the first character of the string can't be parsed. For example: - "123.34": Parses to 123.34 as long as the locale decimal separator is a period. - "1,234.56": Parses to 1234.56 as long as the locale grouping separator is a comma and the decimal separator is a period. - "1.234.567,89": If the grouping separator is anything but a period, parses to 1. - "123x456": Parses to 123. - "text123": Causes the method to throw a ParseException.

The following code example shows how to parse numbers using various separators. Note that the final parse example only parses the first three digits of the number as a space is not a valid separator.

var x = sn_i18n.NumberFormatter.parseWithSeparators('48,837.77', ',', '.');
var y =  sn_i18n.NumberFormatter.parseWithSeparators('77.931,22', '.', ',');
var z = sn_i18n.NumberFormatter.parseWithSeparators('562 339,89', ' ', ',');
var specialCase = sn_i18n.NumberFormatter.parseWithSeparators('400 797,67', '.', ',');

gs.info(x);
gs.info(y);
gs.info(z);
gs.info(specialCase);

Output: