本文介绍两种专业、可靠的方法，将用户输入的9位整数（如123456789）安全转换为带分隔符的社保号字符串（如"123-45-6789"），避免String.format误用导致的运行时异常，并兼顾可读性与健壮性。
本文介绍两种专业、可靠的方法，将用户输入的9位整数（如123456789）安全转换为带分隔符的社保号字符串（如"123-45-6789"），避免`string.format`误用导致的运行时异常，并兼顾可读性与健壮性。
在Java开发中，常需将用户输入的纯数字整型社保号（如123456789）格式化为符合美国标准的XXX-XX-XXXX形式。但直接使用String.format("%03d-%02d-%04d", ssNumber)会失败——因为该方法期望三个独立整数参数，而ssNumber仅是一个值，无法自动拆分。因此，必须显式分离前三位、中间两位和末四位。
以下是两种推荐方案，均以long类型处理（防止9位数溢出int上限2,147,483,647），并附带关键注意事项：
✅ 方法一：数值运算拆分（精确、高效）
public String formatSSNAsNumber(long ssn) {
if (ssn 999_999_999L) {
throw new IllegalArgumentException("SSN must be a 9-digit non-negative number");
}
int part1 = (int) (ssn / 1_000_000); // 前3位：123456789 / 1000000 = 123
int part2 = (int) ((ssn % 1_000_000) / 10_000); // 中2位：(123456789 % 1000000) / 10000 = 45
int part3 = (int) (ssn % 10_000); // 后4位：123456789 % 10000 = 6789
return String.format("%03d-%02d-%04d", part1, part2, part3);
}
✅ 方法二：字符串正则注入（简洁、易读）
public String formatSSNAsString(long ssn) {
if (ssn 999_999_999L) {
throw new IllegalArgumentException("SSN must be a 9-digit non-negative number");
}
String padded = String.format("%09d", ssn); // 补零至9位："123456789" → "123456789"
return padded.replaceFirst("(\d{3})(\d{2})(\d{4})", "$1-$2-$3");
}
⚠️ 重要注意事项
- 输入校验不可省略：真实场景中，用户可能输入少于或多于9位的数字（如12345678或1234567890），务必先验证范围（0 ≤ ssn ≤ 999999999）并处理异常；
- 避免int类型风险：123456789虽在int范围内，但若后续扩展支持带校验位或兼容更大数值，long更安全；
- 不要依赖toString()隐式调用：原代码中toString()方法未做输入检查，且直接格式化易引发IllegalFormatConversionException；
- 前端/后端协同：理想实践是前端用掩码输入框（如___-__-____）约束输入，后端再做二次校验与格式化。
两种方法均通过单元测试验证（例如输入123456789 → "123-45-6789"，输入1234567 → "001-23-4567"）。推荐初学者优先采用字符串正则法——逻辑直观、代码简短；性能敏感场景可选数值法。核心原则始终是：先校验，再拆分，最后格式化。
