intl.numberformat 的 compactdisplay 仅支持 'short' 和 'long' 两个值,分别输出如 '1.2k' 和 '1.2 thousand';其他值被忽略,且 notation: 'compact' 需浏览器 chrome 90+/firefox 96+/safari 15.4+ 支持,低版本静默降级为普通数字。

Intl.NumberFormat 的 compact 选项实际支持哪些值
Intl.NumberFormat 的 notation: 'compact' 确实能生成 1.2k 这类格式,但不是所有浏览器都支持它——Chrome 90+、Firefox 96+、Safari 15.4+ 才正式支持。低于这些版本会静默降级为普通数字(如 1200),不会报错,也**不会抛出 RangeError**,这点容易误判兼容性。
可用的 compactDisplay 值只有两个:'short'(默认,输出 1.2k)和 'long'(输出 1.2 thousand)。传其他值(比如 'auto' 或空字符串)会被忽略。
为什么直接 new Intl.NumberFormat('en', { notation: 'compact' }) 有时不生效
常见原因有三个:
-
minimumSignificantDigits或maximumSignificantDigits没配,导致小数值(如999)仍显示为999而非1k;compact 是“按数量级自动缩写”,不是“强制缩写” - 传入的数字太小(
)或太大(超过 <code>1e15),超出 compact 能处理的范围,会退回到标准表示 - 语言标签不被当前环境识别(例如用
'zh-CN'但在旧 Safari 上未实现中文 compact 规则),也会降级
稳妥做法是显式设置有效精度范围:
const formatter = new Intl.NumberFormat('en', {
notation: 'compact',
compactDisplay: 'short',
maximumFractionDigits: 1,
minimumSignificantDigits: 2,
maximumSignificantDigits: 3
});
formatter.format(1234); // → '1.2k'
formatter.format(999); // → '999'(不会变成 '1k')
如何让 999 显示成 1k:必须手动做数量级映射
Intl.NumberFormat 本身**不提供四舍五入到千/百万级的能力**。它只在自然数量级边界(1000、1000000…)触发缩写,且不改变原始数值的舍入逻辑。
如果业务要求「所有 ≥ 1000 的数都以 k 为单位、且向上取整到 1 位小数」,就得自己预处理数字:
- 先对原始值做数学转换(例如
Math.round(num / 100) / 10实现「百位四舍五入后保留一位小数」) - 再喂给
Intl.NumberFormat,避免它因精度限制展示多余小数 - 注意负数和 0 的边界情况,
0格式化后仍是0,不会变成0k
示例(模拟「999 → 1k」):
function formatCompactK(num) {
if (num === 0) return '0';
if (Math.abs(num) <h3>移动端 iOS Safari 的一个隐藏坑:locale 不能带 -u- 扩展</h3><p>像 <code>'en-u-nu-latn'</code> 这种带 Unicode 扩展的 locale,在 iOS 16.4 之前会直接让 <code>notation: 'compact'</code> 失效(返回原始数字)。必须用基础 locale,如 <code>'en'</code>、<code>'ja'</code>、<code>'zh'</code>。</p><p>另外,Safari 对 <code>compactDisplay: 'long'</code> 的支持比 <code>'short'</code> 更晚,部分版本只认 <code>'short'</code>。线上项目建议加一层运行时检测:</p><pre class="brush:php;toolbar:false;">function supportsCompact() {
try {
const f = new Intl.NumberFormat('en', { notation: 'compact' });
return f.format(1234).includes('k');
} catch {
return false;
}
}
真正麻烦的不是语法怎么写,而是 compact 行为高度依赖运行时环境的 ICU 数据版本——同一份代码,在不同系统更新后的表现可能突变。别只测 Chrome。










