Using custom formatting

Formatting numbers

Custom number format relies on numeral.js in order to provide you with the ability to easily customise your metrics formatting.

The following table should be read this way:

• Number is an example number

• Format is the format you should type in the custom format input on Whaly

• Output show how your metric will display using the custom format

Numbers formats

Number	Format	Output
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
100.1234	00000	00100
1000.1234	000000,0	001,000
10	000.00	010.00
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
100	0o	100th

Currency formats

Number	Format	Output
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 formats

Number	Format	Output
100	0b	100B
1024	0b	1KB
2048	0 ib	2 KiB
3072	0.0 b	3.1 KB
7884486213	0.00b	7.88GB
3467479682787	0.000 ib	3.154 TiB

Percentages formats

Number	Format	Output
1	0%	100%
0.974878234	0.000%	97.488%
-0.43	0 %	-43 %
0.43	(0.000 %)	43.000 %

Time formats

Number	Format	Output
25	00:00:00	0:00:25
238	00:00:00	0:03:58
63846	00:00:00	17:44:06

Exponential formats

Number	Format	Output
1123456789	0,0e+0	1e+9
12398734.202	0.00e+0	1.24e+7
0.000123987	0.000e+0	1.240e-4

Formatting durations

Custom duration format relies on moment duration format in order to provide you with the ability to easily customise your metrics formatting.

To format a duration you can use the following tokens :

Category	Token	Output
milliseconds	S	1 2 3 ...
	SS	01 02 03 ...
seconds	s	1 2 3 ...
	ss	01 02 03 ...
minutes	m	1 2 3 ...
	mm	01 02 03 ...
hours	h	1 2 3 ...
	hh	01 02 03 ...
days	d	1 2 3 ...
	dd	01 02 03 ...
weeks	w	1 2 3 ...
	ww	01 02 03 ...
months	M	1 2 3 ...
	MM	01 02 03 ...
years	y	1 2 3 ...
	yy	01 02 03 ...

Escape token characters within the template string using square brackets.

Examples

Input (in seconds)	format	output
61	mm:ss	01:01
61	m [min], s [sec]	1 min, 1 sec
61	mm [min], ss [sec]	01 min, 01 sec