hutools 0.0.2

All tools sets
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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use chrono::{Date, NaiveDate, ParseResult, TimeZone, Utc};

#[cfg(test)]
mod test {
    use super::*;
    use chrono::{Local, TimeZone};

    #[test]
    fn age_test() {
        let birthday = Local.ymd(2000, 1, 1);
        let date = Local.ymd(2022, 2, 1);
        let age = age(birthday, date);
        assert_eq!(age, Some(22));
    }

    #[test]
    fn age_from_string_test() {
        let birthday = "2000-01-01";
        let date = "2022-02-01";
        let age = age_from_str(birthday, date, None);
        assert_eq!(age, Some(22));
    }
    #[test]
    fn date_from_str_test() {
        let date = "2008-08-08";
        let date = date_utc_from_str(date, None);
        assert_eq!(date, Ok(Utc.ymd(2008, 8, 8)));
    }
    #[test]
    fn date_from_str_error() {
        let date = "2008-08-08 08:08:08";
        let date = date_utc_from_str(date, None);
        assert!(date.is_err())
    }
    #[test]
    fn date_from_str_with_time() {
        let date = "2008-08-08 08:08:08";
        let date = date_utc_from_str(date, Some("%F %T"));
        assert_eq!(date, Ok(Utc.ymd(2008, 8, 8)));
    }
}

///
/// 计算截止到今天的年龄
/// # Arguments
///
/// * `birthday`: 生日
///
/// returns: Option<u32>
///
/// - Some(u32) 当前年龄
/// - None 生日比当前要晚
///
pub fn age_of_now<Tz: TimeZone>(birthday: Date<Tz>) -> Option<u32> {
    let today = Utc::today();
    let birthday = birthday.with_timezone(&Utc);
    age(birthday, today)
}

///
/// 计算截止到今天的年龄
/// # Arguments
///
/// * `birthday`: 字符串格式的年龄格式
///
/// returns: Option<u32>
///
/// - Some(u32) 当前年龄
/// - None 生日比当前要晚
///
pub fn age_of_now_str(birthday: &str) -> Option<u32> {
    let today = Utc::today();
    let birthday = date_utc_from_str(birthday, None).unwrap();
    age(birthday, today)
}

///
/// 计算到某天的年龄
/// # Arguments
///
/// * `birthday`: 生日
/// * `date`: 截止日期
///
/// returns: Option<u32>
///
/// - Some(u32):    到截止日的年龄
/// - None： 到截止日还没有出生
///
/// # Examples
///
/// ```
/// use chrono::{Local, TimeZone};
/// use hutools::date::age;
/// let birthday = Local.ymd(2020,1,1);
/// let date = Local.ymd(2022,3,2);
/// let age = age(birthday,date);
/// assert_eq!(age,Some(2));
/// ```
pub fn age<Tz: TimeZone>(birthday: Date<Tz>, date: Date<Tz>) -> Option<u32> {
    date.years_since(birthday)
}

///
/// 计算年龄
/// # Arguments
///
/// * `birthday`: 生日
/// * `date`: 日期
///
/// returns: Option<u32>
///
/// # Examples
///
/// ```
/// use hutools::date::age_from_str;
/// let birthday = "2000-01-01";
/// let date = "2012-02-01";
/// let age = age_from_str(birthday,date,None);
/// assert_eq!(age,Some(12));
/// ```
pub fn age_from_str(birthday: &str, date: &str, formatter: Option<&str>) -> Option<u32> {
    let formatter = formatter.unwrap_or("%F");
    let birthday = date_utc_from_str(birthday, None).expect("Invalid date");
    let date_naive = NaiveDate::parse_from_str(date, formatter).unwrap();
    let date = Utc.from_utc_date(&date_naive);
    age(birthday, date)
}

///
/// 从字符串转换为Date<Utc>
/// # Arguments
///
/// * `s`: 字符串
/// * `formatter`: 格式化标记，如 Some(`%Y-%m-%d`),如果是None,则使用默认值 `%Y-%m-%d`
///
/// returns: Result<Date<Utc>, ParseError>
///
fn date_utc_from_str(s: &str, formatter: Option<&str>) -> ParseResult<Date<Utc>> {
    let formatter = formatter.unwrap_or("%F");
    let naive_date = NaiveDate::parse_from_str(s, formatter)?;
    let date = Utc.from_utc_date(&naive_date);
    Ok(date)
}