Numeral.js

A javascript library for formatting and manipulating numbers.

Use it

In the Browser

<script src="numeral-min.js"></script>

In Node.js

npm install numeral

var numeral = require('numeral');

Format

Numbers can be formatted to look like money, percentages, times, or even plain old numbers with decimal places, comma delineated thousands, and abbreviations.

var string = numeral(1000).format('0,0');
// 1,000

Numbers

Number	Format	String

Money

Number	Format	String

Percentages

Number	Format	String

Time

Number	Format	String

Unformat

Got a formatted string? Use the unformat function to make it useful again.

var string = numeral().unformat('($10,000.00)');
// -10000

String	Function	Number

Manipulate

Not that you will uses these often, but they're there when you need them.

var number = numeral(1000);

var added = number.add(10);
// 1010

Before	Function	After

Value

The value is always available.

var number = numeral(1000);

var string = number.format('0,0');
// 1,000

var value = number.value();
// 1000

Set

Set the value of your numeral object.

var number = numeral();

number.set(1000);

var value = number.value();
// 1000

Clone

Go ahead and clone any numeral object while you're at it.

var a = numeral(1000);
var b = numeral(a);
var c = a.clone();

var aVal = a.set(2000).value();
// 2000

var bVal = b.value();
// 1000

var cVal = c.add(10).value();
// 1010

Acknowlegements

Numeral.js, while less complex, was inspired by and heavily borrowed from Moment.js