polars-xdt 0.7.0

Time Series Extras (e.g. business day utilities) for Polars

polars-xdt

eXtra stuff for DateTimes

eXtra stuff for DateTimes in Polars.

• ✅ blazingly fast, written in Rust!
• ✅ custom business-day arithmetic!
• ✅ convert to and from multiple time zones!
• ✅ format datetime in different locales!

Installation

First, you need to install Polars.

Then, you'll need to install polars-xdt:

pip install polars-xdt

Then, if you can run

import polars as pl
import polars_xdt  # noqa: F401

print(pl.col('a').xdt)

and see something like <polars_xdt.ExprXDTNamespace at 0x7f5bc943fc10>, it means installation all worked correctly!

Read the documentation for a little tutorial and API reference.

Basic Example

Say we start with

from datetime import date

import polars as pl
import polars_xdt  # noqa: F401


df = pl.DataFrame(
    {"date": [date(2023, 4, 3), date(2023, 9, 1), date(2024, 1, 4)]}
)

Let's shift Date forwards by 5 days, excluding Saturday and Sunday:

result = df.with_columns(
    date_shifted=pl.col("date").xdt.offset_by(
      '5bd',
      weekend=('Sat', 'Sun'),
    )
)
print(result)

shape: (3, 2)
┌────────────┬──────────────┐
│ date       ┆ date_shifted │
│ ---        ┆ ---          │
│ date       ┆ date         │
╞════════════╪══════════════╡
│ 2023-04-03 ┆ 2023-04-10   │
│ 2023-09-01 ┆ 2023-09-08   │
│ 2024-01-04 ┆ 2024-01-11   │
└────────────┴──────────────┘

Read the documentation for more examples!

Logo

Thanks to Olha Urdeichuk for the illustration.