omartood/somali-date

A comprehensive JavaScript library for formatting dates and times in Somali language, supporting multiple calendar systems and cultural features. # somali-date A comprehensive JavaScript library for formatting dates and times in Somali language, supporting multiple calendar systems and cultural features. ## Features - 📅 **Multi-Calendar Support**: Gregorian, Hijri (Islamic), and traditional Somali calendars - 🌍 **Pure Somali Localization**: Authentic Somali month, weekday, and number names - ⏰ **24-hour Time Format**: Standard time formatting with prayer times - 🎭 **Traditional Seasons**: Somali seasonal calendar (Jilaal, Gu, Xagaa, Dayr) - 🔢 **Somali Numerals**: Convert numbers to Somali words - 🎉 **Holiday Detection**: Somali national and Islamic holidays - 💼 **Business Days**: Business day calculations respecting Somali work week - ⏳ **Duration & Age**: Format time periods and ages in Somali - 📱 **Comprehensive CLI**: Feature-rich command-line interface - 🔧 **Easy API**: Simple functions for common use cases - 📝 **TypeScript Support**: Full type definitions included - 🎯 **Flexible Options**: Customizable formatting options ## Installation ```bash npm install somali-date ``` ## Quick Start ```javascript const { today, now, formatDate } = require('somali-date'); // Get today's date console.log(today()); // "Sabti, 9 Agoosto 2025" console.log(today('hijri')); // "Sabti, 14 Safar 1447" console.log(today('both')); // "Sabti, 9 Agoosto 2025 — (14 Safar 1447 Hijri)" // Get current date and time console.log(now()); // "Sabti, 9 Agoosto 2025 18:30" console.log(now('islamic')); // "Sabti, 14 Safar 1447 18:30" // Format specific dates console.log(formatDate('2025-12-25', 'both')); // "Khamiis, 25 Diseembar 2025 — (5 Rajab 1447 Hijri)" ``` ## Documentation - **📚 Complete API Reference** - Detailed documentation of all functions - **💻 CLI Reference** - Command-line interface guide - **📖 Examples** - Practical usage examples and integrations ## Easy Functions (Recommended) ### `formatDate(date, calendar?, options?)` Smart date format …