hijri_date 0.5.1

provides functionality for conversion between hijri and gregorian calander (with wasm target)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

# HijriDate-rs

[![Released API docs](https://docs.rs/hijri_date/badge.svg)](https://docs.rs/hijri_date)

Convert between hijri and gregorian date. (with wasm target)

## Limits

The algorithm used has the following limits:

|           | Minimum | Maximum |
|-----------|---------|---------|
| Hijri     | 1356    | 1499    |
| Gregorian | 1938    | 2076    |

## Minimum Rust version
From version `0.4.0` and onwards the MSRV is **1.51**

## Usage

### Conversion

* Hijri → Gregorian

 ```rust
 use hijri_date::HijriDate;

 let hd = HijriDate::from_hijri(1439,11,19);
 assert_eq!((2018,8,1), (hd.year_gr(), hd.month_gr(), hd.day_gr()));
 ```

* Gregorian → Hijri

 ```rust
 use hijri_date::HijriDate;

 let hd = HijriDate::from_gr(2000,07,31);
 assert_eq!((1421,4,29), (hd.year(), hd.month(), hd.day()));
 ```

### Comparison

 ```rust
 use hijri_date::HijriDate;

 let hd_1 = HijriDate::from_hijri(1500, 12, 30);
 let hd_2 = HijriDate::from_hijri(1356, 1, 1);
 assert!(hd_1 > hd_2);
 ```

### Misc

* Subtract duration from a day

 ```rust
 use hijri_date::{Duration,HijriDate};

 let hd_1 = HijriDate::from_hijri(1420, 06, 15);
 let hd_2 = HijriDate::from_hijri(1420, 05, 29);
 assert_eq!(hd_1 - Duration::days(16), hd_2);
 ```

* Subtract a day from another to get a duration

 ```rust
 use hijri_date::{Duration,HijriDate};

 let hd_1 = HijriDate::from_hijri(1356, 06, 15);
 let hd_2 = HijriDate::from_hijri(1356, 06, 7);
 assert_eq!(hd_1 - hd_2, Duration::days(8));
 ```

### Formatting 

 * Hijri day and month name

 ```rust
 use hijri_date::HijriDate;

 let hd = HijriDate::from_hijri(1439,11,18);
 println!("{}", hd.format("%Y %M %D"));
 ```

* Formatting guide

```
hijri

%Y              hijri_year
%m              hijri_month
%d              hijri_day
%D              hijri_day_name
%M              hijri_month_name
%l              hijri_month_len

gregorian

%gY             gregorian_year
%gm             gregorian_month
%gd             gregorian_day
%gD             gregorian_day_name
%gM             gregorian_month_name
```

## Wasm

To compile to Wasm run:

```
 cargo build --release --target wasm32-unknown-unknown
```

Deno bindings are exposed, see `./deno` for more info

## Credits

I translated [Tytkal's Python library](https://github.com/tytkal/python-hijiri-ummalqura) to Rust.

* **Original algorithm author**

  Suhail Alkowaileet

* **Python version author**

  Khalid Al-hussayen

[Chrono](https://github.com/chronotope/chrono)