Number patterns
Numbers, used in a template, can be displayed using a custom pattern.
In the Script Editor, the pattern can be passed to a function of the formatter
; see formatter. The custom pattern may consist of pattern characters (see below), a prefix and a suffix.
All data fields contain strings.
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.
Note: In output, spaces in a number or amount of money are transformed into non-breaking spaces to ensure that it is not split onto different lines.
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 |
E | Number | Number | Separates mantissa and exponent in scientific notation. Need not be quoted in prefix or suffix. |
; | Subpattern boundary | Number | Separates positive and negative subpatterns |
% | Prefix or suffix | Number | Multiply by 100 and show as percentage |
\u2030 | Prefix or suffix | Number | Multiply by 1000 and show as per mille value |
¤ (\u00A4) | Prefix or suffix | Number | Currency sign, replaced by currency symbol. If doubled, replaced by international currency symbol. If present in a pattern, the monetary decimal separator is used instead of the decimal separator. |
' | Prefix or suffix | Text | Used to quote special characters in a prefix or suffix, for example, "'#'#" formats 123 to "#123". To create a single quote itself, use two in a row: "# o''clock". |
Source: http://docs.oracle.com/javase/7/docs/api/java/text/DecimalFormat.html.