数字（Number）

• 使用指引（做什么、何时用）
• 金额展示：formatCurrency(value, currency?, locale?)，默认使用运行环境语言，无需显式传 locale
• 可读数字：formatNumber(value, groupSizeOrUnit?, locale?)，groupSize 仅传一个数字（默认 3），或传布尔值启用单位缩写
• 百分比：percentage(part,total,digits)，用于占比/进度
• 限制范围：clamp(n,min,max)，防止越界（如评分/页码）
• 精度取整：roundTo(n,digits)，用于价格/汇总

货币与数字格式化

• NumberUtils.formatCurrency(value, currency?, locale?)
• NumberUtils.formatNumber(value, groupSizeOrUnit?, locale?)

Example

import { NumberUtils } from 'nex-lib'
NumberUtils.formatCurrency(1234.56, 'USD')
NumberUtils.formatNumber(1234567.89)            // 默认每 3 位分割
NumberUtils.formatNumber(1234567.89, true, 'en-US') // 单位缩写（K/M/B 或 万/亿，按语言）
NumberUtils.formatNumber(1234567.89, 3)         // 显式传 3，与默认一致

Output

$1,234.56
1,234,567.89
1.2M
1,234,567.89

百分比/范围/取整

• NumberUtils.percentage(part, total, digits?)
• NumberUtils.clamp(n, min, max)
• NumberUtils.roundTo(n, digits)

Example

NumberUtils.percentage(1, 4)
NumberUtils.clamp(10, 0, 5)
NumberUtils.roundTo(1.23456, 2)

Output

25.00%
5
1.23