iOS NSNumberFormatter 設置固定兩位小數顯示（如 1,947.00）

問題場景

使用 NSNumberFormatterDecimalStyle 顯示千分位分隔符，但無小數位：

NSNumberFormatter *formatter = [NSNumberFormatter new];
[formatter setNumberStyle:NSNumberFormatterDecimalStyle];
NSString *formatted = [formatter stringFromNumber:@(1947)];
// 結果："1,947"  -- 期望："1,947.00"

解決方案：設置最小/最大小數位

NSNumberFormatter *formatter = [NSNumberFormatter new];
[formatter setNumberStyle:NSNumberFormatterDecimalStyle];

// 關鍵：強制顯示 2 位小數
[formatter setMinimumFractionDigits:2];
[formatter setMaximumFractionDigits:2];

// 可選：確保分組分隔符
[formatter setUsesGroupingSeparator:YES];
[formatter setGroupingSeparator:@","];  // 或按 locale 自動

NSString *formatted = [formatter stringFromNumber:@(1947)];
// 結果："1,947.00" ✅

核心屬性對比

進階：本地化適配

// 自動適配用戶地區格式（美式 1,947.00 / 德式 1.947,00 / 法式 1 947,00）
formatter.locale = [NSLocale currentLocale]; // 默認即此

// 或強制指定 locale
formatter.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];

Swift 版本

let formatter = NumberFormatter()
formatter.numberStyle = .decimal
formatter.minimumFractionDigits = 2
formatter.maximumFractionDigits = 2
formatter.usesGroupingSeparator = true

let result = formatter.string(from: NSNumber(value: 1947))
// "1,947.00" (en_US locale)

常見坑點

• 只設 maximumFractionDigits 不設 minimum → 1947 顯示為 1,947（無小數）
• 用 setFormat: 硬編碼格式字符串 → 破壞本地化
• 傳入 float 精度不足 → 大數值出現 1,947.0000001，改傳 NSNumber 或 double

總結

雙雙設置 minimumFractionDigits 和 maximumFractionDigits 為同一值，即可強制固定小數位數，配合 DecimalStyle 完美實現「千分位 + 固定兩位小數」的貨幣顯示需求。