hijri-core-dart/.github/wiki/Home.md
2026-05-29 06:34:30 -04:00

28 lines
843 B
Markdown

# hijri_core
Hijri/Gregorian calendar conversion for Dart and Flutter. Pluggable engine system with built-in Umm al-Qura (UAQ) and FCNA calendar implementations. Zero dependencies.
## Install
```yaml
dependencies:
hijri_core: ^1.0.0
```
```dart
import 'package:hijri_core/hijri_core.dart';
final hijri = toHijri(DateTime.utc(2025, 3, 1));
print('${hijri!.hy}/${hijri.hm}/${hijri.hd}'); // 1446/9/1
final greg = toGregorian(1446, 9, 1);
print(greg!.toIso8601String().substring(0, 10)); // 2025-03-01
```
## Contents
- [Quickstart Guide](guides/quickstart) — install, first call, engine selection
- [Advanced Usage](guides/advanced) — pluggable engines, custom calendars
- [API Reference](API-Reference) — full function and type reference
- [Examples](examples/basic-usage) — real-world snippets
- [Contributing](CONTRIBUTING)