NumberFormat.setParseIntegerOnly(true) 使 parse() 方法忽略小数点及之后内容,仅提取开头整数部分;如 "123.45"→123、"-42.99"→-42,但 ".5" 解析失败。

NumberFormat.setParseIntegerOnly(true) 的作用是让解析器在调用 parse() 时**忽略小数点及之后的所有内容**,只尝试提取开头的整数部分,而不是按常规浮点数规则解析。
它不拒绝小数输入,而是“截断式解析”
开启此选项后,像 "123.45"、"456.7abc" 这类字符串仍能成功解析,结果分别是 123 和 456。解析器不会报错,也不会尝试四舍五入或科学计数——它直接停在第一个非数字字符(含小数点)处,返回已读取的整数部分。
- 输入
"789.0"→ 解析为789 - 输入
".5"→ 解析失败(无前置数字),抛出ParseException - 输入
"-42.99"→ 解析为-42(负号被识别,小数点终止解析)
和 setLenient(false) 的区别很关键
setParseIntegerOnly(true) 关注的是“解析范围”,而 setLenient(false) 控制的是“格式严格性”。即使设为非宽松模式,只要开启了 parseIntegerOnly,"100.5" 依然会返回 100;反之,若仅设 lenient=false 但未设 parseIntegerOnly,则 "100.5" 会正常解析为 100.5(类型取决于 NumberFormat 子类,如 DecimalFormat 返回 Double)。
适用场景与注意事项
该设置适合明确只要整数部分、且可容忍用户多输小数位的场景,例如解析版本号("2.1.0" 中取主版本)、坐标粗略值、或兼容旧数据格式。但要注意:
- 它不会做任何数值校验(比如溢出),
"99999999999999999999"可能解析为错误的 int 值(发生截断) - 如果目标是“必须输入纯整数”,应配合正则预校验或使用
Integer.parseInt(),而非依赖此标志 - 重置该选项需显式调用
setParseIntegerOnly(false),它不会随其他属性自动恢复
一个典型误用示例
有人希望用它来“阻止用户输入小数”,这是无效的。它只影响 parse() 行为,不影响文本输入本身,也不改变 format() 输出。若要限制输入内容,需在 UI 层(如 JTextField 输入监听)或验证逻辑中处理。

















