EgyptId.Net 1.0.1

EgyptId.Net

Validation and parsing utilities every Egyptian developer ends up rewriting: the national ID number (الرقم القومي), Egyptian phone numbers, and Arabic text normalization for search. Zero dependencies. Targets netstandard2.0 and net8.0.

Install

dotnet add package EgyptId.Net

Or clone and reference the src/EgyptId project directly.

Quickstart

using EgyptId;

// --- National ID ---
var id = NationalId.TryParse("29508150100010");
if (id.IsValid)
{
    Console.WriteLine(id.BirthDate);          // 8/15/1995
    Console.WriteLine(id.Gender);             // Male
    Console.WriteLine(id.GovernorateNameAr);  // القاهرة
    Console.WriteLine(id.GetAge());           // 31
}

// --- Phone numbers ---
EgyptianPhone.Normalize("01012345678");     // "+201012345678"
EgyptianPhone.Normalize("00201012345678");  // "+201012345678"
EgyptianPhone.Normalize("٠١٠١٢٣٤٥٦٧٨");     // "+201012345678" (Arabic digits work too)

EgyptianPhone.GetCarrier("01112345678");    // PhoneCarrier.Etisalat
EgyptianPhone.GetAreaName("0227950000");    // "Cairo / Giza"

// --- Arabic search normalization ---
ArabicText.EqualsNormalized("أحمد", "احمد");              // true
ArabicText.ContainsNormalized("أهلاً وسهلاً", "اهلا");   // true

API reference

NationalId

NationalIdInfo exposes: Number, IsValid, InvalidReason, BirthDate, Gender (Male/Female), GovernorateCode, GovernorateNameEn, GovernorateNameAr, CheckDigit, and GetAge(DateTime? onDate = null).

Layout decoded: [century][YY][MM][DD][governorate][serial][check], where century digit 2 = 1900s and 3 = 2000s, and an odd serial digit means male / even means female. Arabic-Indic digits (٠-٩) are accepted.

A note on the check digit

The 14th digit is officially described by the civil registry as an optional digit, and its calculation algorithm is not publicly published. Many snippets online claim an algorithm, but none is authoritative — so this library deliberately does not enforce the check digit. It validates structure, real calendar date, and governorate code, and exposes the digit as NationalIdInfo.CheckDigit for completeness. Honest validation beats a confident-looking wrong one.

EgyptianPhone

ArabicText

Building & testing

dotnet build EgyptId.sln
dotnet test EgyptId.sln

CI runs build + tests on every push and pull request.

License

MIT — see LICENSE.