2.13.1

Bug fixes

American Samoa, Canada, Guam, Puerto Rico, United States and United States Virgin Islands incorrectly had a trunk code set.

2.13.0

Features

This release splits out some countries which were incorrectly captured under United States phone numbers in 2.12.0. Other countries in the North American Numbering Plan are due to be introduced in future versions of the library.

It also includes improvements to the nuget package so it passes the health checks in NuGet Package Explorer.

Bug fixes

None

API changes

CountryInfo

+ public static CountryInfo AmericanSamoa { get; }
+ public static CountryInfo Guam { get; }
+ public static CountryInfo PuertoRico { get; }
+ public static CountryInfo UnitedStatesVirginIslands { get; }

2.12.1

This release corrects the central office codes for American Samoa

2.12.0

Features

This release adds support for Canada and United States phone numbers.

It also adds an RFC3966 formatter which is accessed via PhoneNumber.ToString(“RFC3966”) and outputs in the tel:+44-114-272644 format.

Bug fixes

None

API changes

CountryInfo

+ public static CountryInfo Canada { get; }
+ public static CountryInfo UnitedStates { get; }

PhoneNumber

+ public string ToString("RFC3966")

ParseOptions

+ public ParseOptions AllowNorthAmericanCountries()

2.11.0

Features

This release adds support for Australia and Papua New Guinea phone numbers.

It also has:

• Improved the area code data for UK geographic numbers.
• [NotNullWhen(true)] applied to the PhoneNumber parameter of the PhoneNumber.TryParse methods.
• Reduced some array allocations within the CountryInfo type.
• Returns the ParseOptions for the AllowXCountries() methods to allow method chaining.

Bug fixes

None

API changes

CountryInfo

+ public static CountryInfo Australia { get; }
+ public static CountryInfo PapuaNewGuinea { get; }

ParseOptions

+ public ParseOptions AllowAfricanCountries()
+ public ParseOptions AllowAsianCountries()
+ public ParseOptions AllowEuropeanCountries()
+ public ParseOptions AllowOceanianCountries()
- public void AllowAfricanCountries()
- public void AllowAsianCountries()
- public void AllowEuropeanCountries()
- public void AllowOceanianCountries()

2.10.0

Features

This release adds support for .NET 7.0 and additional parsing approaches.

It also drops the .NET 6.0 build although .NET 6.0 is still supported via the .NET Standard 2.1 version of the library.

Bug fixes

None

API changes

PhoneNumber

+ static bool TryParse(string value, out IEnumerable<PhoneNumber> phoneNumbers)
+ static bool TryParse(string value, ParseOptions options, out IEnumerable<PhoneNumber> phoneNumbers)

2.9.1

Fixes an incorrect number range for Benin in Nigeria

2.9.0

Features

This release adds support for Egypt, Nigeria and South Africa phone numbers and obsoletes 2 properties.

It also drops the .NET 5.0 build although .NET 5.0 is still supported via the .NET Standard 2.1 version of the library.

Bug fixes

None

API changes

CountryInfo

+ public static CountryInfo Egypt { get; }
+ public static CountryInfo Nigeria { get; }
+ public static CountryInfo SouthAfrica { get; }
- public string InternationalCallPrefix { get; }

MobilePhoneNumber

- public bool IsDataOnly { get; }

ParseOptions

+ void AllowAfricanCountries()

2.8.0

Features

This release adds support for Moldova, Serbia and Kosovo phone numbers.

Bug fixes

None

API changes

CountryInfo

+ public static CountryInfo Moldova { get; }
+ public static CountryInfo Serbia { get; }
+ public static CountryInfo Kosovo { get; }

2.7.0

Features

This release adds support for Denmark and Finland phone numbers.

Bug fixes

None

API changes

CountryInfo

+ public static CountryInfo Denmark { get; }
+ public static CountryInfo Finland { get; }