polars_xdt.ExprXDTNamespace.format_localized

ExprXDTNamespace.format_localized(format: str, locale: str = 'uk_UA') → XDTExpr

Convert to local datetime in given time zone.

Parameters:

format

Format string, see https://docs.rs/chrono/latest/chrono/format/strftime/index.html for what’s available.

locale

Locale to use for formatting. Defaults to “uk_UA”, because that’s what the OP requested pola-rs/polars#12341.

Returns:

Expr

Expression of data type Utf8.

Examples

>>> from datetime import datetime
>>> import polars_xdt  # noqa: F401
>>> df = pl.DataFrame(
...     {
...         "date_col": [datetime(2024, 8, 24), datetime(2024, 10, 1)],
...     }
... )
>>> df.with_columns(
...     result=pl.col("date_col").xdt.format_localized(
...         "%A, %d %B %Y", "uk_UA"
...     )
... )
shape: (2, 2)
┌─────────────────────┬──────────────────────────┐
│ date_col            ┆ result                   │
│ ---                 ┆ ---                      │
│ datetime[μs]        ┆ str                      │
╞═════════════════════╪══════════════════════════╡
│ 2024-08-24 00:00:00 ┆ субота, 24 серпня 2024   │
│ 2024-10-01 00:00:00 ┆ вівторок, 01 жовтня 2024 │
└─────────────────────┴──────────────────────────┘