Traditional date formatters from cultures around the world
npm install traditional-date-formattersA collection of traditional date formatters from cultures around the world. Each formatter provides traditional calendar systems, month names, and weekday names in various cultural formats.
Simple, focused formatters - no complex calculations, just beautiful traditional formatting!
| Culture | Status |
|---------|--------|
| 🇱🇰 Sinhala | ✅ Available |
| 🇳🇵 Nepali | 🚧 Coming soon |
| 🇮🇷 Persian | 🚧 Coming soon |
| 🇪🇹 Ethiopian | 🚧 Coming soon |
| 🇨🇳 Chinese | 🚧 Coming soon |
bash
npm install traditional-date-formatters
`$3
javascript
import { formatSinhala } from 'traditional-date-formatters';formatSinhala(new Date('2025-01-01'), 'traditional');
// => 2025 දුරුතු මස 01 වන බදාදා
`$3
javascript
import { formatSinhala } from 'traditional-date-formatters';const date = new Date();
formatSinhala(date, 'short'); // සඳුදා
formatSinhala(date, 'medium'); // දුරුතු මස සඳුදා
formatSinhala(date, 'long'); // 2026 දුරුතු මස 12 සඳුදා
formatSinhala(date, 'traditional'); // 2026 දුරුතු මස 12 වන සඳුදා
formatSinhala(date, 'gregorian'); // 2026 ජනවාරි 12 සඳුදා
formatSinhala(date, 'full'); // 2026 ජනවාරි 12 වන සඳුදා (දුරුතු මස)
formatSinhala(date, 'sinhala-numerals'); // 2026 දුරුතු මස 12 වන සඳුදා (using traditional numerals)
`🤝 Contributing
We welcome formatters from ALL cultures!
$3
1. Read Adding a Formatter Guide
2. Create your implementation in
3. Follow the same simple structure as Sinhala
4. Export your formatter from the main - Month names in your language
- Weekday names in your language
- Traditional format structure
- Cultural context documentation
No complex algorithms needed - just the traditional names and formats!
- Cultural Apps - Display dates in users' traditional formats
- Festival Calendars - Show traditional month names
- Educational Tools - Teach traditional calendar systems
- Wedding Invitations - Format dates traditionally
- Temple/Religious Apps - Display dates in cultural context
- Contributing Guidelines
- Adding a New Formatter
- Code of Conduct
1. Preserve cultural heritage through traditional date formatting
2. Simple and maintainable - no complex calculations
3. Community-driven - each culture maintains their own
4. Well-documented - with cultural context
5. Easy to use - simple API for developers
MIT - Each package maintains its own license
- Discussions: Share ideas and ask questions
- Issues: Report bugs or request features
- Pull Requests: Contribute your culture's formatter!
---
Built with ❤️ by the global community
Preserving traditional date formats for future generations