On this page
Overview
Numeric values within total rows (of numeric table columns) can be formatted to look like currency, percentages, times, or plain numbers with decimal places, thousands, and abbreviations. This functionality was introduced in Version 6.2 of the Advanced Tables for Confluence add-on.
Version 6.4 extended the support to provide the ability to force the format on the view of the data rows (FF and M formats). The actual data is not changed, just how it is displayed. This helps to keep the data looking consistent even if the provided data is not. The Column Types parameter is used to specify what type of formatting is done.
Usage
The Formatting Options listed on this page can be defined through the Column Types parameter within the following Macros:
Screenshot
Formatting Options
Acknowledgement
Advanced numeric formatting support is provided using javascript implemented by the Table Library for Bob Swift Add-ons with the help of the Numerals.js library (open source, MIT license). A summary of the relevant parts of the numerals.js documentation is repeated here.
Numbers
Value (Original) | Format Definition | Value (Formatted) |
|---|---|---|
10000 | '0,0.0000' | 10,000.0000 |
10000.23 | '0,0' | 10,000 |
10000.23 | '+0,0' | +10,000 |
-10000 | '0,0.0' | -10,000.0 |
10000.1234 | '0.000' | 10000.123 |
10000.1234 | '0[.]00000' | 10000.12340 |
-10000 | '(0,0.0000)' | (10,000.0000) |
-0.23 | '.00' | -.23 |
-0.23 | '(.00)' | (.23) |
0.23 | '0.00000' | 0.23000 |
0.23 | '0.0[0000]' | 0.23 |
1230974 | '0.0a' | 1.2m |
1460 | '0 a' | 1 k |
-104000 | '0a' | -104k |
1 | '0o' | 1st |
52 | '0o' | 52nd |
23 | '0o' | 23rd |
100 | '0o' | 100th |
Currency
Value (Original) | Format Definition | Value (Formatted) |
|---|---|---|
1000.234 | '$0,0.00' | $1,000.23 |
1000.2 | '0,0[.]00 $' | 1,000.20 $ |
1001 | '$ 0,0[.]00' | $ 1,001 |
-1000.234 | '($0,0)' | ($1,000) |
-1000.234 | '$0.00' | -$1000.23 |
1230974 | '($ 0.00 a)' | $ 1.23 m |
Bytes
Value (Original) | Format Definition | Value (Formatted) |
|---|---|---|
100 | '0b' | 100B |
2048 | '0 b' | 2 KB |
7884486213 | '0.0b' | 7.3GB |
3467479682787 | '0.000 b' | 3.154 TB |
Percentages
Value (Original) | Format Definition | Value (Formatted) |
|---|---|---|
1 | '0%' | 100% |
0.974878234 | '0.000%' | 97.488% |
-0.43 | '0 %' | -43 % |
0.43 | '(0.000 %)' | 43.000 % |
Time
Value (Original) | Format Definition | Value (Formatted) |
|---|---|---|
25 | '00:00:00' | 0:00:25 |
238 | '00:00:00' | 0:03:58 |
63846 | '00:00:00' | 17:44:06 |
Examples
The following example shows how numeric values can be converted in total rows:
Internationalization
The format can be automatically switch to support various international differences by adding a language parameter to the format.
A list of the languages available and their specification is available here.
For example:
ColumnType | Value | Formatted Value |
|---|---|---|
FF"(de)0,0.00 $" | 1.234,5 | 1 234,50 € |
FF"(fr)$0,0.00" | 1 234,5 | €1 234,50 |