Kotlin中如何将Double转换为保留原小数位零的字符串？

我有两个实际小数位数不同的数值，用Double存储时：

123.400 // 实际三位小数
567.80 // 实际两位小数

尝试用DecimalFormat格式化时，要么统一补零到固定位数：

val stringFormat = DecimalFormat("#,###.000")
println(stringFormat.format(123.400)) // 输出123.400
println(stringFormat.format(567.80))  // 输出567.800

要么自动省略末尾零：

val stringFormatZeroAbsent = DecimalFormat("#,###.###")
println(stringFormatZeroAbsent.format(123.400)) // 输出123.4
println(stringFormatZeroAbsent.format(567.80))  // 输出567.8

但我需要保留原始的小数位数，输出结果为：

123.400
567.80

问题根源 #

Double是二进制浮点数类型，它本身不会存储数值的小数位数元数据——123.400和123.4在Double中是完全相同的数值，567.80和567.8也是如此。因此直接用Double无法区分原始的小数位数，自然没法按需求格式化。

解决方案 #

1. 使用BigDecimal存储数值（推荐）

BigDecimal可以精确保留数值的小数位数（scale），只要通过字符串构造器初始化，就能保留原始的精度信息：

import java.math.BigDecimal
import java.text.DecimalFormat

fun main() {
    // 通过字符串初始化，保留原始小数位数
    val num1 = BigDecimal("123.400")
    val num2 = BigDecimal("567.80")

    // 根据每个BigDecimal的scale动态生成格式化模板
    fun formatBigDecimal(num: BigDecimal): String {
        val decimalPattern = if (num.scale() > 0) {
            "#,###.${"0".repeat(num.scale())}"
        } else {
            "#,###"
        }
        return DecimalFormat(decimalPattern).format(num)
    }

    println(formatBigDecimal(num1)) // 输出123.400
    println(formatBigDecimal(num2)) // 输出567.80
}

2. 手动维护小数位数（仅当必须用Double时）

如果无法替换为BigDecimal，可以额外存储每个数值对应的小数位数，再动态生成格式化模板：

import java.text.DecimalFormat

fun main() {
    // 用Pair存储Double值和对应的小数位数
    val numList = listOf(123.400 to 3, 567.80 to 2)

    numList.forEach { (num, scale) ->
        val pattern = "#,###.${"0".repeat(scale)}"
        println(DecimalFormat(pattern).format(num))
    }
}

这种方法需要手动维护小数位数，容易出错，仅作为临时方案。

总结 #

要保留原始小数位数的末尾零，核心是保留数值的精度元数据——BigDecimal是最可靠的选择，它能精准记录原始的小数位数，再配合动态生成的格式化模板即可实现需求。

内容的提问来源于stack exchange，提问作者Barbiyong