UNPKG

numeral/README.md

Version:

3.24 kBMarkdownView Raw

1[Numeral.js](http://numeraljs.com/)
2=======================================================
3
4A javascript library for formatting and manipulating numbers.
5
6[Website and documentation](http://numeraljs.com/)
7
8
9Changelog
10=========
11
12### 1.4.5
13
14Add zeroFormat() function that accepts a string for custom formating of zeros
15
16Add valueOf() function
17
18Chain functionality to language function
19
20Make all minified files have the same .min.js filename ending
21
22### 1.4.1
23
24Bug fix: Bytes not formatting correctly
25
26### 1.4.0
27
28Add optional format for all decimals
29
30### 1.3.4
31
32Remove AMD module id. (This is encouraged by require.js to make the module more portable, and keep it from creating a global)
33
34### 1.3.3
35
36AMD define() compatibility.
37
38### 1.3.2
39
40Bug fix: Formatting some numbers results in the wrong value. Issue #21
41
42### 1.3.1
43
44Bug fix: Minor fix to unformatting parser
45
46### 1.3.0
47
48Add support for spaces before/after $, a, o, b in a format string
49
50Bug fix: Fix unformat for languages that use '.' in ordinals
51
52Bug fix: Fix round up floating numbers with no precision correctly.
53
54Bug fix: Fix currency signs at the end in unformat
55
56### 1.2.6
57
58Add support for optional decimal places
59
60### 1.2.5
61
62Add support for appending currency symbol
63
64### 1.2.4
65
66Add support for humanized filesizes
67
68### 1.2.3
69
70Bug Fix: Fix unformatting for languages that use '.' as thousands delimiter
71
72### 1.2.2
73
74Changed language definition property 'money' to 'currency'
75
76### 1.2.1
77
78Bug fix: Fix unformatting non-negative abbreviations
79
80### 1.2.0
81
82Add language support
83
84Update testing for to include languages
85
86### 1.1.0
87
88Add Tests
89
90Bug fix: Fix difference returning negative values
91
92### 1.0.4
93
94Bug fix: Non negative numbers were displaying as negative when using parentheses
95
96### 1.0.3
97
98Add ordinal formatting using 'o' in the format
99
100### 1.0.2
101
102Add clone functionality
103
104### 1.0.1
105
106Added abbreviations for thousands and millions using 'a' in the format
107
108### 1.0.0
109
110Initial release
111
112
113Acknowlegements
114===============
115
116Numeral.js, while less complex, was inspired by and heavily borrowed from [Moment.js](http://momentjs.com)
117
118
119License
120=======
121
122Numeral.js is freely distributable under the terms of the MIT license.
123
124Copyright (c) 2012 Adam Draper
125
126Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
127files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use,
128copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
129
130The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
131
132THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
\No newline at end of file

1	`[Numeral.js](http://numeraljs.com/)`
2	`=======================================================`
3
4	`A javascript library for formatting and manipulating numbers.`
5
6	`[Website and documentation](http://numeraljs.com/)`
7
8
9	`Changelog`
10	`=========`
11
12	`### 1.4.5`
13
14	`Add zeroFormat() function that accepts a string for custom formating of zeros`
15
16	`Add valueOf() function`
17
18	`Chain functionality to language function`
19
20	`Make all minified files have the same .min.js filename ending`
21
22	`### 1.4.1`
23
24	`Bug fix: Bytes not formatting correctly`
25
26	`### 1.4.0`
27
28	`Add optional format for all decimals`
29
30	`### 1.3.4`
31
32	`Remove AMD module id. (This is encouraged by require.js to make the module more portable, and keep it from creating a global)`
33
34	`### 1.3.3`
35
36	`AMD define() compatibility.`
37
38	`### 1.3.2`
39
40	`Bug fix: Formatting some numbers results in the wrong value. Issue #21`
41
42	`### 1.3.1`
43
44	`Bug fix: Minor fix to unformatting parser`
45
46	`### 1.3.0`
47
48	`Add support for spaces before/after $, a, o, b in a format string`
49
50	`Bug fix: Fix unformat for languages that use '.' in ordinals`
51
52	`Bug fix: Fix round up floating numbers with no precision correctly.`
53
54	`Bug fix: Fix currency signs at the end in unformat`
55
56	`### 1.2.6`
57
58	`Add support for optional decimal places`
59
60	`### 1.2.5`
61
62	`Add support for appending currency symbol`
63
64	`### 1.2.4`
65
66	`Add support for humanized filesizes`
67
68	`### 1.2.3`
69
70	`Bug Fix: Fix unformatting for languages that use '.' as thousands delimiter`
71
72	`### 1.2.2`
73
74	`Changed language definition property 'money' to 'currency'`
75
76	`### 1.2.1`
77
78	`Bug fix: Fix unformatting non-negative abbreviations`
79
80	`### 1.2.0`
81
82	`Add language support`
83
84	`Update testing for to include languages`
85
86	`### 1.1.0`
87
88	`Add Tests`
89
90	`Bug fix: Fix difference returning negative values`
91
92	`### 1.0.4`
93
94	`Bug fix: Non negative numbers were displaying as negative when using parentheses`
95
96	`### 1.0.3`
97
98	`Add ordinal formatting using 'o' in the format`
99
100	`### 1.0.2`
101
102	`Add clone functionality`
103
104	`### 1.0.1`
105
106	`Added abbreviations for thousands and millions using 'a' in the format`
107
108	`### 1.0.0`
109
110	`Initial release`
111
112
113	`Acknowlegements`
114	`===============`
115
116	`Numeral.js, while less complex, was inspired by and heavily borrowed from [Moment.js](http://momentjs.com)`
117
118
119	`License`
120	`=======`
121
122	`Numeral.js is freely distributable under the terms of the MIT license.`
123
124	`Copyright (c) 2012 Adam Draper`
125
126	`Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation`
127	`files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use,`
128	`copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:`
129
130	`The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.`
131
132	`THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.`
\	No newline at end of file