polars-xdt
eXtra stuff for DateTimes
eXtra stuff for DateTimes in Polars.
- ✅ blazingly fast, written in Rust
- ✅ convert to and from multiple time zones
- ✅ format datetime in different locales
- ✅ convert to Julian Dates
- ✅
time-based EWMA(upstreamed to Polars itself) - ✅
custom business-day arithmetic(upstreamed to Polars itself)
Installation
First, you need to install Polars.
Then, you'll need to install polars-xdt:
pip install polars-xdt
Read the documentation for a more examples and functionality.
Basic Example
Say we start with
from datetime import datetime
import polars as pl
import polars_xdt as xdt
df = pl.DataFrame(
{
"local_dt": [
datetime(2020, 10, 10, 1),
datetime(2020, 10, 10, 2),
datetime(2020, 10, 9, 20),
],
"timezone": [
"Europe/London",
"Africa/Kigali",
"America/New_York",
],
}
)
Let's localize each datetime to the given timezone and convert to UTC, all in one step:
result = df.with_columns(
xdt.from_local_datetime(
"local_dt", pl.col("timezone"), "UTC"
).alias("date")
)
print(result)
shape: (3, 3)
┌─────────────────────┬──────────────────┬─────────────────────────┐
│ local_dt ┆ timezone ┆ date │
│ --- ┆ --- ┆ --- │
│ datetime[μs] ┆ str ┆ datetime[μs, UTC] │
╞═════════════════════╪══════════════════╪═════════════════════════╡
│ 2020-10-10 01:00:00 ┆ Europe/London ┆ 2020-10-10 00:00:00 UTC │
│ 2020-10-10 02:00:00 ┆ Africa/Kigali ┆ 2020-10-10 00:00:00 UTC │
│ 2020-10-09 20:00:00 ┆ America/New_York ┆ 2020-10-10 00:00:00 UTC │
└─────────────────────┴──────────────────┴─────────────────────────┘
Read the documentation for more examples!
Logo
Thanks to Olha Urdeichuk for the illustration.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file polars_xdt-0.17.0.tar.gz.
File metadata
- Download URL: polars_xdt-0.17.0.tar.gz
- Upload date:
- Size: 985.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a8fa359443421dbd6e8375c1cfc12732066ecf41fa1ddedd241b3c129e38afab
|
|
| MD5 |
10747ca6a95a8ad8643a9cc699fca083
|
|
| BLAKE2b-256 |
315ff411533e460b9fd89016cd83d213ca538a1dba3e9543f42c548d3dbbcb35
|
File details
Details for the file polars_xdt-0.17.0-cp39-abi3-win_amd64.whl.
File metadata
- Download URL: polars_xdt-0.17.0-cp39-abi3-win_amd64.whl
- Upload date:
- Size: 5.2 MB
- Tags: CPython 3.9+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bb738ed35b59100d91625af7ed26087817411be77aefb673221ce25433476820
|
|
| MD5 |
cceb49c67c37e29d85d7b8acb711b65a
|
|
| BLAKE2b-256 |
68f4fdcfaa6a79303c57c8da2efebb3d89fc72d967ef010c8432f083ecfc8024
|
File details
Details for the file polars_xdt-0.17.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: polars_xdt-0.17.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 6.2 MB
- Tags: CPython 3.9+, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4bc639b88f8a43dea2b816a108dff2368ca97fd9c866881c79d41f51a30cf428
|
|
| MD5 |
a69949b7e112756a031c9df26210bb94
|
|
| BLAKE2b-256 |
cd3c8710682a41fc650c6ad284e2a4f487c2bb43b1563988b14fd4de8b69a67f
|
File details
Details for the file polars_xdt-0.17.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: polars_xdt-0.17.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 5.7 MB
- Tags: CPython 3.9+, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a69cad7f546682c1ef50924be44103e4396056423abfde6886d461e2072a04ea
|
|
| MD5 |
a0bc420623b223c14a94552461baf644
|
|
| BLAKE2b-256 |
4dc5275715daba5b84c92935f73748adc3c1511bc7e41e51fc692275c63df4f8
|
File details
Details for the file polars_xdt-0.17.0-cp39-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: polars_xdt-0.17.0-cp39-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 5.1 MB
- Tags: CPython 3.9+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d64c9cb79a7762ec10011fe5a1471318cc47dc0d6ad2c1c5f1282f3362730f5
|
|
| MD5 |
c2696587e66b7df710c287b96bbed545
|
|
| BLAKE2b-256 |
962d233fc11a52424e8d5674c855e662a13519e97f9c984efb4c9eea7a981851
|
File details
Details for the file polars_xdt-0.17.0-cp39-abi3-macosx_10_12_x86_64.whl.
File metadata
- Download URL: polars_xdt-0.17.0-cp39-abi3-macosx_10_12_x86_64.whl
- Upload date:
- Size: 5.5 MB
- Tags: CPython 3.9+, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.9.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c45b45c1f43cbe8a71124a5d268fa9b8f41fd0bff2a1883c45a6d0ce63917c33
|
|
| MD5 |
b8394d783dd72bccd318636df737836a
|
|
| BLAKE2b-256 |
bdb8b4791a3b0910ef411e25b319b101e5362011fde455e7fafb62971a1449be
|
