电话号码

pydantic_extra_types.phone_numbers 模块提供了 PhoneNumber 数据类型。

此类依赖于 [phonenumbers] 包，该包是 Google [libphonenumber] 的 Python 端口。

PhoneNumber

基类：str

phonenumbers 包的包装器，该包是 Google libphonenumber 的 Python 端口。

supported_regions class-attribute instance-attribute

supported_regions: list[str] = []

支持的区域。如果为空，则支持所有区域。

default_region_code class-attribute

default_region_code: str | None = None

解析不带国际前缀的电话号码时使用的默认区域代码。

phone_format class-attribute instance-attribute

phone_format: str = 'RFC3966'

电话号码的格式。

PhoneNumberValidator dataclass

PhoneNumberValidator(
    default_region: Optional[str] = None,
    number_format: str = "RFC3966",
    supported_regions: Optional[Sequence[str]] = None,
)

使用 phonenumbers 包（Google libphonenumber 的 Python 端口）的电话号码的 pydantic 预验证器。

旨在用于使用 typing.Annotated 类型构造创建自定义 pydantic 数据类型。

参数

名称	类型	描述	默认值
default_region	str | None	解析不带国际前缀的电话号码时使用的默认区域代码。如果为 None（默认值），则必须在电话号码中以国际前缀形式提供区域。	None
number_format	str	要返回的电话号码的格式。有关有效值，请参阅 phonenumbers.PhoneNumberFormat。	'RFC3966'
supported_regions	list[str]	支持的区域。如果为空，则支持所有区域（默认值）。	None

返回值：str：格式化的电话号码。

示例

MyNumberType = Annotated[ Union[str, phonenumbers.PhoneNumber], PhoneNumberValidator() ] USNumberType = Annotated[ Union[str, phonenumbers.PhoneNumber], PhoneNumberValidator(supported_regions=['US'], default_region='US') ]

class SomeModel(BaseModel): phone_number: MyNumberType us_number: USNumberType