kuwaitdata

Comprehensive Kuwait data library — governorates, areas, phone codes, timezone, and search utilities.

مكتبة بيانات الكويت الشاملة — المحافظات، المناطق، أرقام الهواتف، المنطقة الزمنية، وأدوات البحث.

Installation | التثبيت

npm install kuwaitdata

Features | المميزات

• 6 Kuwait governorates with Arabic & English names | ٦ محافظات كويتية بالعربي والإنجليزي
• 108 areas distributed across all governorates | ١٠٨ منطقة موزعة على جميع المحافظات
• Phone number detection & formatting | كشف وتنسيق أرقام الهواتف
• Timezone utilities | أدوات المنطقة الزمنية
• Bilingual search (Arabic & English) | بحث ثنائي اللغة
• Zero dependencies | بدون أي مكتبات إضافية

Usage | الاستخدام

const { governorates, areas, search, phone, timezone } = require('kuwaitdata');

Governorates | المحافظات

// Get all governorates | الحصول على جميع المحافظات
governorates.getAll();
// [{ id: 1, code: 'KU', nameAr: 'العاصمة', nameEn: 'Capital' }, ...]

// Get by code | البحث بالرمز
governorates.getByCode('KU');
// { id: 1, code: 'KU', nameAr: 'العاصمة', nameEn: 'Capital' }

// Get by ID | البحث بالمعرف
governorates.getById(2);
// { id: 2, code: 'HW', nameAr: 'حولي', nameEn: 'Hawalli' }

// Count | العدد
governorates.count(); // 6

// Get all codes | الحصول على جميع الرموز
governorates.getCodes(); // ['KU', 'HW', 'FR', 'AH', 'JA', 'MK']

Areas | المناطق

// Get all areas | الحصول على جميع المناطق
areas.getAll();
// [{ id: 1, governorateCode: 'KU', nameAr: 'الشرق', nameEn: 'Sharq' }, ...]

// Get areas by governorate | المناطق حسب المحافظة
areas.getByGovernorate('HW');
// [{ id: 25, governorateCode: 'HW', nameAr: 'حولي', nameEn: 'Hawalli' }, ...]

// Get area by ID | البحث بالمعرف
areas.getById(26);
// { id: 26, governorateCode: 'HW', nameAr: 'السالمية', nameEn: 'Salmiya' }

// Count all areas | عدد جميع المناطق
areas.count(); // 108

// Count areas per governorate | عدد المناطق لكل محافظة
areas.countByGovernorate();
// { KU: 24, HW: 15, FR: 17, AH: 23, JA: 17, MK: 12 }

Search | البحث

// Search governorates (Arabic) | البحث في المحافظات بالعربي
search.searchGovernorates('حول');
// [{ id: 2, code: 'HW', nameAr: 'حولي', nameEn: 'Hawalli' }]

// Search governorates (English) | البحث بالإنجليزي
search.searchGovernorates('capital');
// [{ id: 1, code: 'KU', nameAr: 'العاصمة', nameEn: 'Capital' }]

// Search areas | البحث في المناطق
search.searchAreas('السالمية');
// [{ id: 26, governorateCode: 'HW', nameAr: 'السالمية', nameEn: 'Salmiya' }]

// Search areas within a governorate | البحث في مناطق محافظة معينة
search.searchAreas('Salmiya', 'HW');

// Search all (governorates + areas) | البحث الشامل
search.searchAll('حول');
// { governorates: [...], areas: [...] }

Phone | الهاتف

// Country code | رمز الدولة
phone.getCountryCode(); // '+965'

// Get all phone data | جميع بيانات الهاتف
phone.getAll();

// Get all operators | جميع المشغلين
phone.getOperators();
// [{ name: 'Zain', nameAr: 'زين', type: 'mobile', prefixes: ['9', '6'] }, ...]

// Mobile operators only | مشغلي الموبايل فقط
phone.getMobileOperators();

// Detect operator from number | كشف المشغل من الرقم
phone.detectOperator('96001234');
// { name: 'Zain', nameAr: 'زين', type: 'mobile', prefixes: ['9', '6'] }

phone.detectOperator('+96555001234');
// { name: 'STC', nameAr: 'STC', type: 'mobile', prefixes: ['5'] }

// Format number | تنسيق الرقم
phone.formatNumber('96001234');
// '+965 9600 1234'

phone.formatNumber('+96596001234');
// '+965 9600 1234'

Timezone | المنطقة الزمنية

// Get timezone info | معلومات المنطقة الزمنية
timezone.getInfo();
// { timezone: 'Asia/Kuwait', utcOffset: '+03:00', utcOffsetHours: 3, dst: false, ... }

// Get timezone name | اسم المنطقة الزمنية
timezone.getTimezone(); // 'Asia/Kuwait'

// Get current Kuwait time | الوقت الحالي في الكويت
timezone.getCurrentTime();
// '3/9/2026, 10:30:00 PM'

// Format date in English | تنسيق التاريخ بالإنجليزي
timezone.formatDate('2024-01-15T12:00:00Z');
// 'January 15, 2024 at 03:00:00 PM'

// Format date in Arabic | تنسيق التاريخ بالعربي
timezone.formatDateAr('2024-01-15T12:00:00Z');
// '١٥ يناير ٢٠٢٤ في ٣:٠٠:٠٠ م'

Data Summary | ملخص البيانات

| Governorate | المحافظة | Code | Areas | |---|---|---|---| | Capital | العاصمة | KU | 24 | | Hawalli | حولي | HW | 15 | | Farwaniya | الفروانية | FR | 17 | | Ahmadi | الأحمدي | AH | 23 | | Jahra | الجهراء | JA | 17 | | Mubarak Al-Kabeer | مبارك الكبير | MK | 12 |

Phone Operators | مشغلي الهاتف

| Operator | المشغل | Type | Prefixes | |---|---|---|---| | Zain | زين | Mobile | 9, 6 | | STC | STC | Mobile | 5 | | Ooredoo | أوريدو | Mobile | 7 | | Landline | هاتف أرضي | Landline | 2 |

License

MIT