polars_xdt.ExprXDTNamespace.day_name#

ExprXDTNamespace.day_name(locale: str | None = None) → XDTExpr#

Return day name, in specified locale (if specified).

Returns:

Expr: Expression of data type Utf8.

See also

format_localized: format according to locale.

Examples

>>> from datetime import datetime
>>> import polars_xdt  # noqa: F401
>>> df = pl.DataFrame(
...     {
...         "ts": [datetime(2020, 10, 25), datetime(2020, 10, 26)],
...     }
... )
>>> df.with_columns(
...     english_day_name=pl.col("ts").xdt.day_name(),
...     french_day_name=pl.col("ts").xdt.day_name("fr_FR"),
...     ukrainian_day_name=pl.col("ts").xdt.day_name("uk_UA"),
... )
shape: (2, 4)
┌─────────────────────┬──────────────────┬─────────────────┬────────────────────┐
│ ts                  ┆ english_day_name ┆ french_day_name ┆ ukrainian_day_name │
│ ---                 ┆ ---              ┆ ---             ┆ ---                │
│ datetime[μs]        ┆ str              ┆ str             ┆ str                │
╞═════════════════════╪══════════════════╪═════════════════╪════════════════════╡
│ 2020-10-25 00:00:00 ┆ Sunday           ┆ dimanche        ┆ неділя             │
│ 2020-10-26 00:00:00 ┆ Monday           ┆ lundi           ┆ понеділок          │
└─────────────────────┴──────────────────┴─────────────────┴────────────────────┘