Numeral.js — библиотека для форматирования чисел

На создание библиотеки для удобного форматирования чисел программиста и веб-дизайнера Адама Дрэйпера вдохновила аналогичная библиотека для даты и времени — moment.js. Numeral.js позволяет задавать число знаков после запятой, символы-разделители для дробной части и групп разрядов, формат представления валют, процентов, времени, аббревиатуры для миллионов, миллиардов, мегабайтов и т.п. Кроме того, можно восстанавливать числовые значения из существующего строкового представления. Библиотека распространяется под лицензией MIT.

Numeral работает в браузерах и под Node.js. Подключение библиотеки:

В браузере из cdnjs.com:

<script src="//cdnjs.cloudflare.com/ajax/libs/numeral.js/1.4.1/numeral.min.js"></script>

В Node.js:

npm install numeral

var numeral = require('numeral');

Использование:

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

Числа

Валюта

Байты

Проценты

Время

Расформатирование

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

Арифметика

var number = numeral(1000);

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

Форматирование нулевого значения

var number = numeral(0);

numeral.zeroFormat('N/A');

var zero = number.format('0.0')    // 'N/A'

Работа с объектами number

Получение числового значения

var number = numeral(1000);

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

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

Установка значения

var number = numeral();

number.set(1000);

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

Разность

var number = numeral(1000),
    value = 100;

var difference = number.difference(value);    // 900

Клонирование

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

Локализация

В библиотеку встроены базовые функции локализации. Уже есть рудиментарная поддержка русского языка.

// load a language
numeral.language('fr', {
    delimiters: {
        thousands: ' ',
        decimal: ','
    },
    abbreviations: {
        thousand: 'k',
        million: 'm'
    },
    ordinal : function (number) {
        return number === 1 ? 'er' : 'ème';
    },
    currency: {
        symbol: '€'
    }
});

// switch between languages
numeral.language('fr');

Ссылки

Гитхаб. Официальный сайт.

Автор: ilya42

Источник