一个用于格式化和处理数字的Javascript库。

部署

<!-- 加载Numeral.js -->
<script src="numeral.min.js"></script>

NPM 部署

npm install numeral

相关链接

Github地址:https://github.com/adamwdraper/Numeral-js
官方网站:http://numeraljs.com/

相关CDN

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

实例化

var myNumeral = numeral(1000);

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

var myNumeral2 = numeral('1,000');

var value2 = myNumeral2.value();
// 1000
Input输出
numeral(974)974
numeral(0.12345)0.12345
numeral(‘10,000.12’)10000.12
numeral(’23rd’)23
numeral(‘$10,000.00’)10000
numeral(‘100B’)100
numeral(‘3.467TB’)3467000000000
numeral(‘-76%’)-0.76
numeral(‘2:23:57’)NaN

格式化

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

数字格式化

Number参数输出
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

货币格式化

Number参数输出
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

字节格式化

Number参数输出
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

百分比格式化

Number参数输出
1‘0%’100%
0.974878234‘0.000%’97.488%
-0.43‘0 %’-43 %
0.43‘(0.000 %)’43.000 %

时间格式化

Number参数输出
25’00:00:00′0:00:25
238’00:00:00′0:03:58
63846’00:00:00′17:44:06
实际测试下来,应该是按照秒数来输出时间

指数格式化

Number参数输出
1123456789‘0,0e+0’1e+9
12398734.202‘0.00e+0’1.24e+7
0.000123987‘0.000e+0’1.240e-4

方法

计算相关

var number = numeral(1000);

var added = number.add(10);
// 1010
数字Function输出
1000.add(100)1100
1100.subtract(100)1000
1000.multiply(100)100000
100000.divide(100)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

设置

设置默认格式化

var number = numeral(1000);

number.format();
// '1,000'

numeral.defaultFormat('$0,0.00');

number.format();
// '$1,000.00'

设置 0 或 null 的默认输出值

var number = numeral(0);
var nullNumber = numeral(null);

numeral.zeroFormat('N/A');
numeral.nullFormat('N/A');

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

var na = nullNumber.format('0.0')
// 'N/A'

本地化

// load a locale
numeral.register('locale', 'chs', {
    delimiters: {
        thousands: ',',
        decimal: '.'
    },
    abbreviations: {
        thousand: '千',
        million: '百万',
        billion: '十亿',
        trillion: '兆'
    },
    ordinal: function (number) {
        return '.';
    },
    currency: {
        symbol: '¥'
    }
});

// switch between locales
numeral.locale('chs');

自定义格式化

// load a format
numeral.register('format', 'percentage', {
    regexps: {
        format: /(%)/,
        unformat: /(%)/
    },
    format: function(value, format, roundingFunction) {
        var space = numeral._.includes(format, ' %') ? ' ' : '',
            output;

        value = value * 100;

        // check for space before %
        format = format.replace(/\s?\%/, '');

        output = numeral._.numberToFormat(value, format, roundingFunction);

        if (numeral._.includes(output, ')')) {
            output = output.split('');

            output.splice(-1, 0, space + '%');

            output = output.join('');
        } else {
            output = output + space + '%';
        }

        return output;
    },
    unformat: function(string) {
        return numeral._.stringToNumber(string) * 0.01;
    }
});

// use your custom format
numeral().format('0%');

阿里云盘下载地址

「Numeral.js」https://www.aliyundrive.com/s/KNfKDZz7jBC