Python-phonenumbers 库使用指南：电话号码解析与格式化

Python-phonenumbers 库使用指南：电话号码解析与格式化

python-phonenumbers Python port of Google's libphonenumber 项目地址: https://gitcode.com/gh_mirrors/py/python-phonenumbers

概述

Python-phonenumbers 是一个功能强大的电话号码处理库，它基于 Google 的 libphonenumber 库实现，提供了电话号码解析、格式化、验证和地理信息查询等功能。这个库特别适合需要处理国际电话号码的应用场景。

核心功能

1. 电话号码解析

使用 parse() 方法可以将各种格式的电话号码字符串解析为标准的 PhoneNumber 对象：

import phonenumbers

# 解析国际格式号码
x = phonenumbers.parse("+442083661177", None)

# 解析本地格式号码（需要指定国家代码）
y = phonenumbers.parse("020 8366 1177", "GB")

2. 电话号码格式化

库提供了多种格式化选项，可以将 PhoneNumber 对象格式化为不同的显示样式：

# 国际格式
print(phonenumbers.format_number(x, phonenumbers.PhoneNumberFormat.INTERNATIONAL))
# 输出: +44 20 8366 1177

# 国内格式
print(phonenumbers.format_number(x, phonenumbers.PhoneNumberFormat.NATIONAL))
# 输出: 020 8366 1177

# E164格式（纯数字）
print(phonenumbers.format_number(x, phonenumbers.PhoneNumberFormat.E164))
# 输出: +442083661177

3. 实时输入格式化

AsYouTypeFormatter 类可以在用户输入电话号码时实时进行格式化：

formatter = phonenumbers.AsYouTypeFormatter("US")
print(formatter.input_digit("6"))  # 输出: 6
print(formatter.input_digit("5"))  # 输出: 65
print(formatter.input_digit("0"))  # 输出: 650
print(formatter.input_digit("2"))  # 输出: 650-2
# 继续输入会逐步完善格式

4. 电话号码匹配

可以从文本中提取电话号码：

text = "Call me at 510-748-8230 if it's before 9:30, or on 703-4800500 after 10am."
for match in phonenumbers.PhoneNumberMatcher(text, "US"):
    print(match)
    # 输出匹配的电话号码及其位置信息

高级功能

1. 电话号码验证

# 验证号码有效性
is_valid = phonenumbers.is_valid_number(x)

# 检查号码类型
number_type = phonenumbers.number_type(x)

2. 地理位置查询

from phonenumbers import geocoder
print(geocoder.description_for_number(x, "en"))
# 输出号码所属地区信息

3. 运营商信息查询

from phonenumbers import carrier
print(carrier.name_for_number(x, "en"))
# 输出号码所属运营商信息

4. 时区查询

from phonenumbers import timezone
print(timezone.time_zones_for_number(x))
# 输出号码所属时区

使用场景

1. 用户输入处理：自动格式化用户输入的电话号码
2. 数据清洗：统一数据库中的电话号码格式
3. 短信服务：验证和格式化接收/发送的电话号码
4. 国际应用：处理不同国家的电话号码格式
5. 数据分析：从文本中提取电话号码信息

最佳实践

1. 总是存储 E164 格式的电话号码
2. 在显示时根据用户所在地区选择合适的格式
3. 对用户输入使用 AsYouTypeFormatter 提供更好的输入体验
4. 在处理用户输入前先进行验证

总结

Python-phonenumbers 库为电话号码处理提供了全面的解决方案，从基本的解析和格式化到高级的地理位置和运营商查询，是开发涉及电话号码功能的应用程序时的理想选择。其 API 设计简洁明了，文档完善，能够满足各种复杂的电话号码处理需求。

python-phonenumbers Python port of Google's libphonenumber 项目地址: https://gitcode.com/gh_mirrors/py/python-phonenumbers