Java NumberFormat 怎样限制只解析输入中的整数部分

在导入报表、读取配置或处理表单数字时，经常会遇到这样的输入：128.75。如果业务只需要它的整数部分，直接调用普通的 NumberFormat.parse() 往往会把小数也解析进结果。真正的开关不是改格式化模板，而是调用 setParseIntegerOnly(true)。

想让 NumberFormat 只解析整数部分，可以先用匹配业务地区的 NumberFormat，再调用 setParseIntegerOnly(true)。对于 Locale.US，输入 128.75 会得到整数 128；这表示在小数分隔符处停止解析，不代表做了一次四舍五入。

先还原小数被带入结果的现象

问题通常出现在“显示格式”和“输入解析”被混在一起的时候。setMaximumFractionDigits(0) 只影响格式化输出，不能改变解析行为；官方文档也明确区分了格式化的整数/小数位设置与解析控制。

下面的示例固定使用 Locale.US，这样小数分隔符就是点号，读者可以把注意力放在 NumberFormat 的解析语义上：

import java.text.NumberFormat;
import java.util.Locale;

public class ParseNumberDemo {
    public static void main(String[] args) throws Exception {
        NumberFormat format = NumberFormat.getNumberInstance(Locale.US);
        // parse 默认会读取小数部分；这里的结果类型可能是 Double。
        Number parsed = format.parse("128.75");
        System.out.println(parsed);
    }
}

这段代码的问题不在 parse 找不到数字，而在于它默认按普通数字解析。只要需求是“读取数字的整数部分”，就应该明确设置解析模式，而不是依赖字符串截断。

打开只解析整数部分的开关

NumberFormat 提供了 setParseIntegerOnly(boolean)。传入 true 后，解析器会把当前 Locale 的小数分隔符视为整数部分的结束位置。对于英文地区的 128.75，返回值就是 128。

import java.text.NumberFormat;
import java.util.Locale;

public class IntegerOnlyDemo {
    public static void main(String[] args) throws Exception {
        NumberFormat format = NumberFormat.getNumberInstance(Locale.US);
        // 只取整数部分，遇到小数分隔符就停止解析。
        format.setParseIntegerOnly(true);

        Number parsed = format.parse("128.75");
        // Long 表示这个输入在当前解析规则下没有小数结果。
        System.out.println(parsed); // 128
    }
}

这个设置作用于解析实例本身。如果同一个实例稍后又要解析带小数的金额，就必须恢复设置或直接创建职责更清楚的新实例。NumberFormat 通常也不是线程安全的，服务端不要让多个线程无保护地共享一个可变格式器。

分清解析截取与格式化舍入

这是本题最容易产生误会的地方：只解析整数部分不是四舍五入。解析处理的是输入文本读到哪里，格式化处理的是一个已经得到的数应该怎样显示。

例如，12.6 在整数解析模式下会停在小数点前，结果倾向于表达“读到了整数 12”；而用整数格式器去格式化一个浮点数时，官方工厂方法会配置相应的舍入规则，默认舍入方式和解析截断不是一回事。

import java.text.NumberFormat;
import java.util.Locale;

public class ParseAndFormatDemo {
    public static void main(String[] args) throws Exception {
        NumberFormat parser = NumberFormat.getNumberInstance(Locale.US);
        // 解析阶段只读取整数部分，不对文本做四舍五入。
        parser.setParseIntegerOnly(true);
        Number parsed = parser.parse("12.6");

        NumberFormat integerFormatter = NumberFormat.getIntegerInstance(Locale.US);
        // 格式化阶段处理的是数值，不能拿它替代输入校验。
        String formatted = integerFormatter.format(12.6);
        System.out.println(parsed + " / " + formatted);
    }
}

因此，变量命名最好把 parser 和 formatter 分开。若业务要求“按规则四舍五入后再保存整数”，应使用明确的数值转换或舍入策略；若业务要求“只读小数点之前的输入”，才使用 setParseIntegerOnly(true)。

用 ParsePosition 判断输入是否读完

整数解析模式解决了“结果只要整数”的问题，但它不会自动替你判断整段输入是否完全合法。NumberFormat.parse(String) 从字符串开头尝试解析，解析成功后可能只消费前缀；当输入后面还有不应出现的字符时，单看返回值可能把问题隐藏起来。

import java.text.NumberFormat;
import java.text.ParsePosition;
import java.util.Locale;

public class ParsePositionDemo {
    public static void main(String[] args) {
        String input = "128.75kg";
        NumberFormat format = NumberFormat.getNumberInstance(Locale.US);
        // 只解析整数，但仍保留游标，方便判断后面是否有业务不允许的文本。
        format.setParseIntegerOnly(true);

        ParsePosition position = new ParsePosition(0);
        Number parsed = format.parse(input, position);
        // 解析失败时返回 null，并从 errorIndex 读取失败位置。
        if (parsed == null) {
            System.out.println("parse failed at " + position.getErrorIndex());
            return;
        }

        // index 指向下一个未消费字符；若要求整段输入为数字，这里还要继续判断。
        boolean fullyConsumed = position.getIndex() == input.length();
        System.out.println(parsed + " / fullyConsumed=" + fullyConsumed);
    }
}

这里的关键是两个结果同时看：parsed 告诉你得到的数，position.getIndex() 告诉你读到了哪里。若业务只想从一段描述中提取开头的整数，尾随文本可以保留；若业务要校验整个字段，就应把“游标已到末尾”纳入成功条件。

按业务边界选择 NumberFormat 用法

还有一个容易忽略的边界：getIntegerInstance(Locale) 返回的格式器本身就配置为只解析输入的整数部分，同时也有面向格式化的整数舍入设置。如果代码同时承担“读取表单”和“显示金额”，建议分别创建解析器和格式化器，避免一个可变实例的配置互相污染。

常见问题

调用 setMaximumFractionDigits(0) 能不能只解析整数？

不能。它主要影响格式化时允许显示多少位小数，官方文档明确说明这类最小/最大位数设置不改变解析行为。

整数解析模式会把 12.9 四舍五入成 13 吗？

不会把解析动作理解成四舍五入。它在当前 Locale 的小数分隔符处停止读取；需要舍入时，应在得到数值后使用明确的舍入规则。

为什么 ParsePosition 的 index 没有到字符串末尾？

因为解析方法允许只消费输入前缀。对于整数解析模式，小数部分或其后的文本可能仍未消费；是否接受这类输入取决于业务是否允许尾随内容。

总结

Java NumberFormat 只解析整数部分的核心设置是 setParseIntegerOnly(true)。它改变的是文本解析边界，不是格式化舍入规则；Locale 决定数字符号的解释，ParsePosition 则帮助你判断输入到底消费到了哪里。把这三个边界分开，才能既拿到需要的整数，又不会误把截取、舍入和完整校验混成一个动作。