2020.1

grouped(value)
Formats a number using a thousands separator. Which separator is used depends on the
Locale, see "Locale" on page760.
value
A number. This can be a value from a field that contains a SmallInteger, BigInteger, Float,
SmallCurrency or LargeCurrency.
Number patterns
Numbers, used in a template and originating from a field in a record set, can be displayed using
a custom pattern.
You can enter the pattern via the Text Script Wizard; see "Using the Text Script Wizard" on
page780 and "Formatting variable data" on page784. Note that for this to work, in the
DataMapper the field that contains the value must be set to Integer, Float, or Currency.
In the Script Editor, the pattern can be passed to a function of the formatter; see "formatter" on
page1257. The custom pattern may consist of pattern characters (see below), a prefix and a
suffix.
Note that strings need to be converted to a number before they can be formatted this way.
The repetition of pattern letters determines the exact presentation. For example, the pattern
"00000" limits the number to 5 digits and adds leading zeros to any numbers that are not 5
digits long.
Pattern characters
Symbol Location Localized? Meaning
0 Number Text Digit
# Number Year Digit, zero shows as absent
. Number Year Decimal separator or monetary decimal separator
- Number Month Minus sign
, Number Number Grouping separator
Page 1274