hijri_date 0.2.2

provides functionality for conversion between hijri and gregorian calander
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

 # HijriDate-rs 

[Documentation](https://docs.rs/hijri_date/)

Convert between hijri and gregorian date.

 The algorithm used to convert between dates is limited to:

 ```     
 minimum handled hijri year = 1356
 maximum handled hijri year = 1500

 minimum handled gregorian year = 1938
 maximum handled gregorian year = 2076
 ```

 ## Usage

 *convert to gregorian*

 ```rust
 extern crate hijri_date;
 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));
 ```

 *convert to hijri*

 ```rust
 extern crate hijri_date;
 use hijri_date::HijriDate;

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

 *hijri day and month name*

 ```rust
 extern crate hijri_date;
 use hijri_date::HijriDate;

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

 *compare dates*

 ```rust
 extern crate hijri_date;
 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);
 ```

  *substract duration from a day*

 ```rust
 extern crate hijri_date;
 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);
 ```

  *substract a day from an other to get a duration*

 ```rust
 extern crate hijri_date;    
 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));
 ```

 *formating 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
    


# Credits
I translated the python version 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)