polars 0.53.0

DataFrame library based on Apache Arrow
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

use polars::prelude::*;

#[test]
fn test_datetime_parse_overflow_7631() {
    let df = df![
        "year"=> &[2020, 2021, 2022],
        "month"=> &[1, 2, 3],
        "day"=> &[1, 2, 3],
    ]
    .unwrap()
    .lazy();

    let df = df.with_column(
        concat_str([col("year"), col("month"), col("day")], "-", false) // produces e.g., `2020-1-1`
            .str()
            .strptime(
                DataType::Datetime(TimeUnit::Milliseconds, None),
                StrptimeOptions {
                    format: Some("%Y-%m-%_d".into()),
                    ..Default::default()
                },
                lit("latest"),
            )
            .alias("dt1"),
    );
    let actual = df.collect().unwrap();

    let expected = DataFrame::new_infer_height(vec![
        Column::new("year".into(), &[2020, 2021, 2022]),
        Column::new("month".into(), &[1, 2, 3]),
        Column::new("day".into(), &[1, 2, 3]),
        Column::new(
            "dt1".into(),
            &[
                AnyValue::Datetime(1577836800000, TimeUnit::Milliseconds, None),
                AnyValue::Datetime(1612224000000, TimeUnit::Milliseconds, None),
                AnyValue::Datetime(1646265600000, TimeUnit::Milliseconds, None),
            ],
        ),
    ])
    .unwrap();

    assert_eq!(actual, expected);
}

#[test]
#[cfg(feature = "dtype-date")]
fn test_date_temporal_operations_11991() {
    use polars::prelude::*;

    let normal_date = 18628; // 2021-01-01
    let s = Int32Chunked::new("".into(), &[normal_date])
        .into_date()
        .into_series();

    let year = s.year().unwrap();
    assert_eq!(year.get(0), Some(2021));

    let month = s.month().unwrap();
    assert_eq!(month.get(0), Some(1));

    let day = s.day().unwrap();
    assert_eq!(day.get(0), Some(1));

    // Null values should remain null (regression test for #15313)
    let s_with_null = Int32Chunked::new("".into(), &[Some(18628), None])
        .into_date()
        .into_series();

    let year_with_null = s_with_null.year().unwrap();
    assert_eq!(year_with_null.get(0), Some(2021));
    assert_eq!(year_with_null.get(1), None);
}

#[test]
#[cfg(feature = "dtype-date")]
fn test_out_of_range_date_year_11991() {
    use polars::prelude::*;

    // Out-of-range dates should return null instead of panicking or returning wrong values
    // Regression test for #11991 where out-of-range dates silently returned the input value
    let out_of_range_date = -96_465_659;
    let s = Int32Chunked::new("".into(), &[out_of_range_date])
        .into_date()
        .into_series();

    let year = s.year().unwrap();
    // Should return null, not the input value -96465659
    assert_eq!(year.get(0), None);

    // is_leap_year should also return null for out-of-range dates
    let is_leap = s.is_leap_year().unwrap();
    assert_eq!(is_leap.get(0), None);
}