Philiprehberger.PhoneValidator

International phone number validation and formatting based on ITU-T E.164 with country detection.

Installation

dotnet add package Philiprehberger.PhoneValidator

Usage

using Philiprehberger.PhoneValidator;

var isValid = Phone.IsValid("+14155552671");
// true

Validate a Number

using Philiprehberger.PhoneValidator;

var result = Phone.Validate("+442071838750");
// result.IsValid       -> true
// result.E164          -> "+442071838750"
// result.CountryCode   -> "44"
// result.NationalNumber -> "2071838750"
// result.Error         -> null

Format as E.164

using Philiprehberger.PhoneValidator;

var e164 = Phone.Format("+1 (415) 555-2671");
// "+14155552671"

var international = Phone.Format("+49 30 123456", PhoneFormat.International);
// "+49 301 234 56"

var national = Phone.Format("+33 1 23 45 67 89", PhoneFormat.National);
// "123 456 789"

Normalize Input

using Philiprehberger.PhoneValidator;

var cleaned = Phone.Normalize("  +1 (415) 555-2671  ");
// "+14155552671"

var local = Phone.Normalize("  0301-234-5678 ");
// "03012345678"

Detect Country

using Philiprehberger.PhoneValidator;

var country = Phone.DetectCountry("+81 90 1234 5678");
// "Japan"

var unknown = Phone.DetectCountry("+999 123456");
// null

API

Phone

Method	Description
IsValid(string number)	Returns true if the number is a valid E.164 phone number
Validate(string number)	Validates and parses the number into a PhoneResult
Format(string number, PhoneFormat format)	Formats the number in the specified format (default E.164)
Normalize(string number)	Strips non-digit characters (except leading +), trims whitespace
DetectCountry(string number)	Returns the country name for the number's dialing code, or null

PhoneResult

Property	Type	Description
IsValid	bool	Whether the phone number is valid
Error	string?	Error message if invalid
E164	string?	Number in E.164 format if valid
CountryCode	string?	Dialing country code (e.g. "1", "44")
NationalNumber	string?	National portion without country code

PhoneFormat

Value	Description
E164	+{code}{number} with no separators
International	+{code} {grouped number} with spaces
National	National number only, grouped with spaces

Development

dotnet build src/Philiprehberger.PhoneValidator.csproj --configuration Release

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT