將 Decimal 轉(zhuǎn)換為格式化的金額字符串

extension Decimal {
    /// 將 Decimal 轉(zhuǎn)換為格式化的金額字符串
    ///
    /// - Parameters:
    ///   - scale: 小數(shù)點后保留的位數(shù),默認保留 2 位(常用于金額)
    ///   - roundingMode: 四舍五入的規(guī)則,默認使用銀行家舍入法(.bankers)
    ///   - locale: 用于格式化的區(qū)域設(shè)置,默認使用當(dāng)前系統(tǒng)區(qū)域
    ///   - showSymbol: 是否顯示貨幣符號(如¥、$等),默認顯示
    /// - Returns: 格式化后的金額字符串,如 "¥1,234.56" 或 "1,234.56"
    func toMoneyString(scale: Int = 2,
                       roundingMode: NSDecimalNumber.RoundingMode = .bankers,
                       locale: Locale = .current,
                       showSymbol: Bool = false) -> String {
        
        // Step 1: 對 Decimal 值進行四舍五入處理
        var value = self                       // 原始 Decimal 值
        var rounded = Decimal()               // 存放舍入后的值
        NSDecimalRound(&rounded, &value, scale, roundingMode)
        
        // Step 2: 設(shè)置 NumberFormatter 格式化器
        let formatter = NumberFormatter()
        formatter.locale = locale                                      // 使用指定地區(qū)設(shè)置
        formatter.numberStyle = showSymbol ? .currency : .decimal     // 設(shè)置格式:帶符號或純數(shù)字
        formatter.minimumFractionDigits = scale                       // 保留最少的小數(shù)位數(shù)
        formatter.maximumFractionDigits = scale                       // 保留最多的小數(shù)位數(shù)
        formatter.roundingMode = roundingMode.toNumberFormatterRoundingMode // 設(shè)置四舍五入策略
        
        // Step 3: 若不顯示貨幣符號,手動清空符號
        if !showSymbol {
            formatter.currencySymbol = ""     // 清除本地貨幣符號(如 ¥、$)
        }

        // Step 4: 返回格式化后的字符串,若失敗返回空字符串
        return formatter.string(from: rounded as NSDecimalNumber) ?? ""
    }
}
extension NSDecimalNumber.RoundingMode {
    /// 將 NSDecimalNumber 的舍入模式映射為 NumberFormatter 的舍入模式
    var toNumberFormatterRoundingMode: NumberFormatter.RoundingMode {
        switch self {
        case .plain:     return .halfUp        // 四舍五入
        case .down:      return .down          // 向零方向舍入
        case .up:        return .up            // 遠離零方向舍入
        case .bankers:   return .halfEven      // 銀行家舍入法
        @unknown default:
            return .halfEven                  // 默認 fallback
        }
    }
}

僅供參考

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容