polars.Series.dt.millennium#

Series.dt.millennium() → Expr[source]#

Extract the millennium from underlying representation.

Applies to Date and Datetime columns.

Returns the millennium number in the calendar date.

Returns:

Expr: Expression of data type Int32.

Examples

>>> from datetime import date
>>> s = pl.Series(
...     "dt",
...     [
...         date(999, 12, 31),
...         date(1897, 5, 7),
...         date(2000, 1, 1),
...         date(2001, 7, 5),
...         date(3002, 10, 20),
...     ],
... )
>>> s.dt.millennium()
shape: (5,)
Series: 'dt' [i32]
[
    1
    2
    2
    3
    4
]