Egydata

Structured Egyptian geographical and timezone data for Node.js and the browser.

Provides a complete, offline dataset of Egyptian governorates, cities, landline and mobile area codes, and timezone utilities — with zero dependencies.

View on GitHub | View on NPM

Installation

npm install egydata

Quick Start

// CommonJS
const { governorates, cities, phoneArea, timezone } = require("egydata");

// ESM
import { governorates, cities, phoneArea, timezone } from "egydata";

Usage

Governorates

const { governorates } = require("egydata");

// Get all 27 governorates
const all = governorates.getAll();
// [{ id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' }, ...]

// Find by code
const cairo = governorates.getByCode("CAI");
// { id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' }

// Find by id
const gov = governorates.getById(2);
// { id: 2, code: 'ALX', name: 'الإسكندرية', nameEn: 'Alexandria' }

// Search (Arabic or English, partial match)
const results = governorates.search("alex");
// [{ id: 2, code: 'ALX', name: 'الإسكندرية', nameEn: 'Alexandria' }]

const arResults = governorates.search("القاهرة");
// [{ id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' }]

Cities

const { cities } = require("egydata");

// Get cities by governorate code
const cairoCities = cities.getByGovernorate("CAI");
// [{ id: 1, name: 'مدينة نصر', nameEn: 'Nasr City', governorateCode: 'CAI' }, ...]

// Find by id
const city = cities.getById(131);
// { id: 131, name: 'شرم الشيخ', nameEn: 'Sharm El Sheikh', governorateCode: 'SIS' }

// Search cities (Arabic or English, partial match)
const found = cities.search("Maadi");
// [{ id: 3, name: 'المعادي', nameEn: 'Maadi', governorateCode: 'CAI' }]

Phone Area Codes

const { phoneArea } = require("egydata");

// Get all area codes (landline and mobile)
const all = phoneArea.getAll();
// [{ code: '02', region: 'القاهرة والجيزة', regionEn: 'Cairo & Giza' }, ...]

// Look up a region by code
const region = phoneArea.getRegion("03");
// { code: '03', region: 'الإسكندرية', regionEn: 'Alexandria' }

// Find area code by region name
const entry = phoneArea.getCode("Mansoura");
// { code: '050', region: 'الدقهلية (المنصورة)', regionEn: 'Dakahlia (Mansoura)' }

Timezone

const { timezone } = require("egydata");

console.log(timezone.name); // 'Africa/Cairo'
console.log(timezone.offset); // '+02:00'

const now = timezone.now(); // Current date/time in Egypt (Date object)
console.log(now.toISOString());

console.log(timezone.isDST()); // true or false depending on current date (Egypt resumed DST in 2023)

API Reference

governorates

| Method | Parameters | Returns | Description | | ----------------- | ------------------ | -------------------------------- | ------------------------------------------------------------ | | getAll() | — | Array<Governorate> | Returns all 27 Egyptian governorates | | getByCode(code) | string | Governorate \| undefined | Find a governorate by its code (e.g. 'CAI') | | getById(id) | number \| string | Governorate \| undefined | Find a governorate by its numeric id | | search(query) | string | Array<Governorate> | Search by Arabic or English name (partial, case-insensitive) |

Governorate shape: { id: number, code: string, name: string, nameEn: string }

cities

| Method | Parameters | Returns | Description | | --------------------------- | ------------------ | ----------------------- | ------------------------------------------------------------ | | getByGovernorate(govCode) | string | Array<City> | Get all cities in a governorate | | getById(id) | number \| string | City \| undefined | Find a city by its numeric id | | search(query) | string | Array<City> | Search by Arabic or English name (partial, case-insensitive) |

City shape: { id: number, name: string, nameEn: string, governorateCode: string }

phoneArea

| Method | Parameters | Returns | Description | | --------------------- | ---------- | -------------------------- | ------------------------------------------------------- | | getAll() | — | Array<AreaCode> | Returns all Egyptian landline and mobile area codes | | getRegion(code) | string | AreaCode \| undefined | Look up region info by area code | | getCode(regionName) | string | AreaCode \| undefined | Find area code entry by region name (Arabic or English) |

AreaCode shape: { code: string, region: string, regionEn: string }

timezone

| Property / Method | Returns | Description | | ----------------- | ---------------- | --------------------------------------------------- | | name | 'Africa/Cairo' | IANA timezone identifier | | offset | '+02:00' | UTC offset | | now() | Date | Current date/time in Egypt | | isDST(date?) | boolean | Whether DST is active (optionally for a given date) |

Data Coverage

• 27 governorates with Arabic and English names
• 389 cities and districts across all governorates
• 30 landline and mobile area codes
• Full timezone support for Africa/Cairo

License

MIT