Manipulating Numbers

Numeral.js provides a set of chainable methods for performing common mathematical operations. These methods modify the internal value of the numeral object.

.add(value)

Adds a number to the current value.

var number = numeral(100.5);
number.add(9.5);
console.log(number.value()); // 110

.subtract(value)

Subtracts a number from the current value.

var number = numeral(50);
number.subtract(25.5);
console.log(number.value()); // 24.5

.multiply(value)

Multiplies the current value by another number.

var number = numeral(10);
number.multiply(5);
console.log(number.value()); // 50

.divide(value)

Divides the current value by another number.

var number = numeral(100);
number.divide(4);
console.log(number.value()); // 25

.set(value)

Sets the internal value of the numeral object, replacing the existing one.

var number = numeral(1000);
console.log(number.value()); // 1000

number.set(2000);
console.log(number.value()); // 2000

.value()

Retrieves the raw, unformatted number.

var number = numeral('1,234.56');
console.log(number.value()); // 1234.56

.difference(value)

Calculates the absolute difference between the numeral's current value and the provided value.

var number = numeral(100);
var diff = number.difference(150);
console.log(diff); // 50

var number2 = numeral(-20);
var diff2 = number2.difference(30);
console.log(diff2); // 50