岩石教程

Numeral.js

2024-07-02 09:38:36 136
Numeral.js 是一个用于格式化和操作数字的 JavaScript 库，轻量级且功能强大，能够处理各种复杂的数字格式化需求。它广泛应用于前端开发中，帮助开发者以简洁的方式进行数字处理。

特点

  • 轻量级：体积小，适合前端项目使用。
  • 多种格式：支持货币、百分比、时间、字节等多种格式化。
  • 可扩展性：支持自定义格式和语言扩展。
  • 直观的 API：简单易用的 API 接口，便于开发者快速上手。

使用场景

  • 显示货币金额
  • 显示百分比
  • 显示文件大小
  • 显示时间和日期
  • 任何需要数字格式化的场景

安装方式

可以通过 npm 或者直接引用脚本文件的方式来安装 Numeral.js：

使用 npm 安装

npm install numeral

使用 script 标签引入

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

使用示例

格式化数字

// 格式化为千分位
numeral(1000).format('0,0'); // '1,000'

// 格式化为货币
numeral(1000).format('$0,0.00'); // '$1,000.00'

// 格式化为百分比
numeral(0.25).format('0.00%'); // '25.00%'

解析字符串为数字

numeral().unformat('$10,000.00'); // 10000
numeral().unformat('23%'); // 0.23
numeral().unformat('123.45k'); // 123450

常用 API 介绍

  • numeral(value)：创建一个 Numeral 实例。
  • format(formatString)：格式化数字为指定的格式。
  • unformat(string)：将格式化的字符串解析为数字。
  • add(value)：增加指定的值。
  • subtract(value)：减少指定的值。
  • multiply(value)：乘以指定的值。
  • divide(value)：除以指定的值。
  • value()：获取原始数字值。
  • set(value)：设置新的数字值。

官方资料