Titanium SDK 中的 Intl.NumberFormat 国际化数字格式化指南

Titanium SDK 中的 Intl.NumberFormat 国际化数字格式化指南

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk

概述

在跨平台移动应用开发中，数字的国际化显示是一个常见需求。Titanium SDK 通过 Intl.NumberFormat 对象提供了强大的数字格式化功能，能够根据不同的地区和语言环境，将数字转换为符合当地习惯的字符串表示形式。

核心功能

Intl.NumberFormat 是一个不可变对象，主要用于：

1. 将数字转换为本地化的数字字符串
2. 提供多种格式化选项控制整数和小数位数的显示
3. 支持货币值、百分比值和科学计数法的格式化

基本用法

创建格式化器

const formatter = new Intl.NumberFormat([locales[, options]])

• locales：可选参数，指定地区代码（如 'en-US' 或 'zh-CN'），建议使用 Ti.Locale.currentLocale 获取当前设备地区
• options：可选参数，指定格式化选项

简单示例

const formatter = new Intl.NumberFormat('zh-CN');
console.log(formatter.format(1234567.89)); // 输出：1,234,567.89

格式化选项详解

数字样式（style）

• decimal：默认值，普通数字格式
• currency：货币格式，需配合 currency 选项使用
• percent：百分比格式，自动将值乘以100

常用选项

1. useGrouping：是否使用分组分隔符（如千分位逗号）
2. minimumIntegerDigits：最小整数位数（不足补零）
3. minimumFractionDigits：最小小数位数（不足补零）
4. maximumFractionDigits：最大小数位数（超出部分四舍五入）
5. maximumSignificantDigits：最大有效数字位数

实用场景示例

1. 货币格式化

const options = {
    style: 'currency',
    currency: 'USD',  // 美元
    minimumFractionDigits: 2
};
const formatter = new Intl.NumberFormat('zh-CN', options);
console.log(formatter.format(1234.5)); // 输出：$1,234.50

2. 百分比格式化

const formatter = new Intl.NumberFormat('zh-CN', {
    style: 'percent',
    maximumFractionDigits: 1
});
console.log(formatter.format(0.456)); // 输出：45.6%

3. 固定小数位数

const formatter = new Intl.NumberFormat('zh-CN', {
    minimumFractionDigits: 2,
    maximumFractionDigits: 2
});
console.log(formatter.format(123.4)); // 输出：123.40
console.log(formatter.format(123.456)); // 输出：123.46

4. 科学计数法（仅Android）

const formatter = new Intl.NumberFormat('zh-CN', {
    notation: 'scientific'
});
console.log(formatter.format(123456)); // 输出：1.23456E5

高级功能

formatToParts 方法

将格式化结果分解为各个组成部分，便于自定义显示：

const formatter = new Intl.NumberFormat('zh-CN', {
    style: 'currency',
    currency: 'USD'
});
const parts = formatter.formatToParts(1234.56);
// 输出类似：
// [
//   { type: "currency", value: "$" },
//   { type: "integer", value: "1" },
//   { type: "group", value: "," },
//   { type: "integer", value: "234" },
//   { type: "decimal", value: "." },
//   { type: "fraction", value: "56" }
// ]

resolvedOptions 方法

获取格式化器当前使用的选项：

const options = formatter.resolvedOptions();
console.log(options);

平台兼容性说明

1. notation 选项（科学计数法）仅Android支持
2. currencyDisplay 选项在Android上总是显示货币符号
3. localeMatcher 选项在Android上被忽略

最佳实践建议

1. 始终使用 Ti.Locale.currentLocale 作为地区参数，确保应用自动适应用户设备设置
2. 对于货币显示，确保同时设置 style: 'currency' 和 currency 选项
3. 对于需要精确控制显示格式的场景，组合使用 minimumFractionDigits 和 maximumFractionDigits
4. 在需要自定义格式化输出时，使用 formatToParts 方法而非直接使用格式化字符串

通过合理使用 Intl.NumberFormat，开发者可以轻松实现应用的数字国际化显示需求，提升用户体验。

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk