google/libphonenumber
Libphonenumber
This project is an international phone number library used for parsing, formatting, and validating phone numbers based on the E.164 standard. It provides a validation engine and parser to convert raw strings into structured objects and verify if numbers conform to regional numbering rules.
The library includes a metadata provider that maps phone numbers to geographic locations, time zones, and network carriers. It can distinguish between line types, such as fixed-line or mobile, to verify SMS compatibility and identify original network operators.
Additional capabilities include extracting phone numbers from unstructured text, generating sample numbers for testing, and migrating stale numbers to current formats using renumbering recipes. It also supports incremental input formatting and the conversion of numbers into dialable strings based on user location.
Features
- International Phone Number Libraries - Provides a comprehensive toolset for parsing, formatting, and validating global telephony numbers based on the E.164 standard.
- Phone Number Research - Maps phone numbers to geographic locations, time zones, and network carriers.
- Numbering Plan Validation - Verifies phone number validity against stored minimum and maximum length constraints for specific regions.
- Phone Number Parsing - Extracts structured data from raw text strings to identify country codes and national numbering plans.
- Phone Number Parsing & Formatting - Converts raw phone number data into standardized international or national display formats.
- Phone Number Validation - Checks if a phone number is mathematically possible and conforms to regional numbering rules.
- Telephony Metadata Retrieval - Identifies the carrier, time zone, and geographic region associated with a phone number using regional metadata.
- Phone Number Formatting - Transforms raw digits into standardized strings using region-specific masks and formatting templates.
- E.164 Standardization - Converts locally formatted phone numbers into the international E.164 standard based on a specified country.
- Telephony Metadata Loaders - Implements a metadata engine that loads regional phone number rules from CSV files.
- Dialable String Generation - Converts phone numbers into dialable strings based on the user's current location and device type.
- Line Type Identification - Determines if a phone number is a mobile or fixed-line type to ensure it can receive text messages.
- Phone Number Extraction - Scans raw text strings to locate and isolate phone numbers embedded within the content.
- Phone Number Migration - Transforms stale phone numbers into current formats by applying prefix and length overrides.
- Incremental Input Formatting - Provides real-time visual updates to phone number formatting as a user enters digits.
- Line Type Identification - Distinguishes between fixed-line, mobile, toll-free, and other specialized phone number categories.
- Regional Telephony Indexing - Organizes geographic and timezone information by country code to enable efficient lookups of local dialing rules.
- Telephony Time Zone Determination - Determines the local time zone associated with a specific phone number.
- Telecom Carrier Lookups - Provides trie-based lookup tables to map phone number prefixes to their respective telecommunications carriers.
- Phone Number Migration - Updates stale phone numbers to current dialable formats using renumbering recipes.
- Communication and Identity - Parses, formats, and validates international phone numbers.
