如何将电话号码格式化为X(XXX)XXX-XXX的美国格式？解决PhoneNumberUtils.formatNumber()输出格式不符问题

我懂你想要的格式——X(XXX)XXX-XXX，但Android自带的PhoneNumberUtils.formatNumber()确实只会输出X-XXX-XXX-XXX，没法直接满足需求。这里有两个实用的解决办法，你可以根据场景选择：

方案一：手动字符串处理（适合简单场景） #

如果你的电话号码已经是纯数字，且确定是标准的美国号码（10位本地号或11位带国家码1），可以直接通过字符串截取和拼接来实现格式转换：

// 先清理掉号码里的非数字字符（比如括号、横线、空格）
String rawPhone = data.getUserPhone().replaceAll("[^0-9]", "");
String formattedPhone = "";

// 处理10位本地号（比如1234567890 → 1(234)567-890）
if (rawPhone.length() == 10) {
    formattedPhone = String.format("%s(%s)%s-%s",
            rawPhone.substring(0, 1),
            rawPhone.substring(1, 4),
            rawPhone.substring(4, 7),
            rawPhone.substring(7));
}
// 处理11位带国家码的号码（比如11234567890 → 1(234)567-890）
else if (rawPhone.length() == 11 && rawPhone.startsWith("1")) {
    formattedPhone = String.format("%s(%s)%s-%s",
            rawPhone.substring(0, 1),
            rawPhone.substring(1, 4),
            rawPhone.substring(4, 7),
            rawPhone.substring(7));
}

// 最后设置到TextView
holder.tv_vehicle.setText("Phone #: " + formattedPhone);

这种方法简单直接，不需要额外依赖，但缺点是不够灵活——如果号码格式不标准（比如带字母、长度不对），可能会出问题。

方案二：使用Google的libphonenumber库（专业健壮） #

如果你的应用需要处理各种复杂的号码输入（比如用户输入带分隔符的号码、不同格式的美国号码），推荐用Google官方的libphonenumber库，它能自动解析、验证号码，还能灵活控制输出格式。

步骤1：添加依赖 #

在你的build.gradle（Module级别）里添加依赖：

implementation 'com.googlecode.libphonenumber:libphonenumber:8.13.20'

步骤2：编写格式化代码 #

import com.google.i18n.phonenumbers.NumberParseException;
import com.google.i18n.phonenumbers.PhoneNumberUtil;
import com.google.i18n.phonenumbers.Phonenumber;

// ...

PhoneNumberUtil phoneUtil = PhoneNumberUtil.getInstance();
try {
    // 解析号码，"US"指定国家为美国
    Phonenumber.PhoneNumber numberProto = phoneUtil.parse(data.getUserPhone(), "US");
    
    // 提取国家码和本地号码部分
    String countryCode = String.valueOf(numberProto.getCountryCode());
    String nationalNumber = String.valueOf(numberProto.getNationalNumber());
    
    // 按照目标格式拼接
    if (nationalNumber.length() == 10) {
        String formattedPhone = countryCode + "(" + nationalNumber.substring(0, 3) + ")" 
                + nationalNumber.substring(3, 6) + "-" + nationalNumber.substring(6);
        holder.tv_vehicle.setText("Phone #: " + formattedPhone);
    } else {
        // 如果号码长度不符合预期， fallback 到原始号码或其他处理
        holder.tv_vehicle.setText("Phone #: " + data.getUserPhone());
    }
} catch (NumberParseException e) {
    // 处理解析失败的情况（比如无效号码）
    holder.tv_vehicle.setText("Phone #: " + data.getUserPhone());
    e.printStackTrace();
}

这个方案的优势在于，它能自动处理各种输入格式（比如用户输入(123) 456-7890或者1-234-567-890），还能验证号码是否有效，适合生产环境使用。

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