polars_xdt.ExprXDTNamespace.month_name#

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

Return month 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, 11, 26)],
...     }
... )
>>> df.with_columns(
...     english_month_name=pl.col("ts").xdt.month_name(),
...     french_month_name=pl.col("ts").xdt.month_name("fr_FR"),
...     ukrainian_month_name=pl.col("ts").xdt.month_name("uk_UA"),
... )
shape: (2, 4)
┌─────────────────────┬────────────────────┬───────────────────┬──────────────────────┐
│ ts                  ┆ english_month_name ┆ french_month_name ┆ ukrainian_month_name │
│ ---                 ┆ ---                ┆ ---               ┆ ---                  │
│ datetime[μs]        ┆ str                ┆ str               ┆ str                  │
╞═════════════════════╪════════════════════╪═══════════════════╪══════════════════════╡
│ 2020-10-25 00:00:00 ┆ October            ┆ octobre           ┆ жовтня               │
│ 2020-11-26 00:00:00 ┆ November           ┆ novembre          ┆ листопада            │
└─────────────────────┴────────────────────┴───────────────────┴──────────────────────┘