使用Google的libphonenumber解析和格式化電話號碼

電話號碼在我們的日常生活中扮演着重要的角色。然而，在不同的國家和地區，電話號碼的規則和格式可能不相同。因此，處理和驗證電話號碼的過程變得越來越複雜。Google的libphonenumber是用於處理電話號碼的開源庫，可以幫助我們輕鬆地解析、格式化和驗證各種電話號碼。本文將介紹如何使用libphonenumber來解析和格式化電話號碼。

一、引入libphonenumber庫

要開始使用libphonenumber，首先需要將它引入到我們的項目中。

// 在pom.xml（Java項目）中添加以下依賴
<dependency>
    <groupId>com.googlecode.libphonenumber</groupId>
    <artifactId>libphonenumber</artifactId>
    <version>8.12.13</version>
</dependency>

二、解析電話號碼

libphonenumber提供了幾種不同的解析電話號碼的方法。我們先看一個基本的例子：

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

public class PhoneNumberParser {

    public static void parsePhoneNumber(String phoneNumber, String regionCode) {
        try {
            PhoneNumberUtil phoneUtil = PhoneNumberUtil.getInstance();
            PhoneNumber numberProto = phoneUtil.parse(phoneNumber, regionCode);
            System.out.println("Country code: " + numberProto.getCountryCode());
            System.out.println("National number: " + numberProto.getNationalNumber());
        } catch (Exception e) {
            System.err.println("NumberParseException was thrown: " + e.toString());
        }
    }
}

// 調用parsePhoneNumber方法
String phoneNumber = "+86 13800138000";
String regionCode = "CN";
PhoneNumberParser.parsePhoneNumber(phoneNumber, regionCode);

上面的代碼演示了如何解析中國的手機號碼。我們使用了PhoneNumberUtil類的parse方法解析電話號碼，並將解析結果傳遞給numberProto對象。然後，我們可以使用numberProto對象的getCountryCode方法和getNationalNumber方法來獲取國家碼和本地號碼。

除了上面的方法之外，libphonenumber還提供了更多的方法來解析電話號碼。例如，isValidNumber方法可以驗證電話號碼是否有效；而plusSignIsMeansIDD和normalizeDigitsOnly方法分別用於處理國際電話號碼中的“+”號和刪除電話號碼中的任何非數字字符。這裡不再贅述，讀者可以參考官方文檔來了解更多細節。

三、格式化電話號碼

除了解析電話號碼外，libphonenumber還可以格式化電話號碼，使它們更容易閱讀和理解。下面是一個簡單的例子：

import com.google.i18n.phonenumbers.PhoneNumberUtil;
import com.google.i18n.phonenumbers.Phonenumber.PhoneNumber;
import com.google.i18n.phonenumbers.PhoneNumberUtil.PhoneNumberFormat;

public class PhoneNumberFormatter {

    public static void formatPhoneNumber(String phoneNumber, String regionCode) {
        try {
            PhoneNumberUtil phoneUtil = PhoneNumberUtil.getInstance();
            PhoneNumber numberProto = phoneUtil.parse(phoneNumber, regionCode);
            String formattedNumber = phoneUtil.format(numberProto, PhoneNumberFormat.INTERNATIONAL);
            System.out.println("Formatted number: " + formattedNumber);
        } catch (Exception e) {
            System.err.println("NumberParseException was thrown: " + e.toString());
        }
    }
}

// 調用formatPhoneNumber方法
String phoneNumber = "+13800138000";
String regionCode = "CN";
PhoneNumberFormatter.formatPhoneNumber(phoneNumber, regionCode);

上面的代碼示例演示了如何使用libphonenumber格式化中國的手機號碼。我們使用PhoneNumberUtil類的format方法將號碼轉換為國際格式，並將結果傳遞給formattedNumber。然後，我們可以打印出格式化後的電話號碼。

除了國際格式之外，libphonenumber還提供了多種不同的格式來呈現電話號碼。例如，E164格式、國家格式和RFC3966格式等。例如，PhoneNumberFormat.E164可以將電話號碼轉換為E.164格式（即國際電話號碼格式），而PhoneNumberFormat.NATIONAL則可以將電話號碼轉換為國家本地格式。

四、總結

本文介紹了如何使用Google的libphonenumber庫來解析和格式化電話號碼。我們可以使用libphonenumber的不同方法來解析電話號碼的國家、地區和本地號碼，並將其轉換為多種不同的格式。這使得我們可以更容易地處理和驗證各種電話號碼，並將其用於不同的應用程序中。