在 iOS 專案裡,把浮點數轉成指定位數的字串幾乎是每個 App 都會遇到的需求,尤其是金額、統計數字、進度百分比這類欄位。與其自己動手做乘法、取模、加偏移量,不如直接交給系統內建的 NSNumberFormatter,程式碼短、行為可靠,也不容易出現精度上的意外。
下面是一個可以直接複用的小工具方法,透過傳入格式字串與浮點值,回傳格式化後的文字:
- (NSString *)decimalWithFormat:(NSString *)format floatValue:(float)value {
NSNumberFormatter *formatter = [[NSNumberFormatter alloc] init];
[formatter setPositiveFormat:format];
return [formatter stringFromNumber:[NSNumber numberWithFloat:value]];
}
呼叫方式如下:
NSLog(@"----%@---", [self decimalWithFormat:@"0.0000" floatValue:0.334]); NSLog(@"----%@---", [self decimalWithFormat:@"0.0000" floatValue:0.334569]); NSLog(@"----%@---", [self decimalWithFormat:@"0.0000" floatValue:0.334519]);
主控台輸出的結果:
2014-03-19 15:44:45.262 TestNumberFormatter[3056:60b] ----0.3340--- 2014-03-19 15:44:45.263 TestNumberFormatter[3056:60b] ----0.3346--- 2014-03-19 15:44:45.263 TestNumberFormatter[3056:60b] ----0.3345---
格式字串裡的 0 代表「這一位一定要顯示」,不足位數就補零;如果寫成 #,則代表「有數字才顯示」,尾端多餘的零會被省略。實務上想要固定小數位數、讓數字對齊好看,用 0 是最省事的選擇。
NSNumberFormatter 會受到系統地區設定影響,某些地區會使用逗號當小數點。若你要的是機器可讀的固定格式,建議改用 NSNumberFormatterDecimalStyle 或指定 NSLocale,避免上傳後端時格式跑掉。setPositiveFormat:,負數會走系統預設樣式。如果需要自訂負數外觀,記得補上 setNegativeFormat:。NSDecimalNumber 搭配 NSDecimalRound 系列 API,而不要依賴 float。