polars.Series.dt.to_string#

Series.dt.to_string(format: str) → Series[source]#

Convert a Date/Time/Datetime column into a String column with the given format.

Similar to cast(pl.String), but this method allows you to customize the formatting of the resulting string.

Parameters:

format: Format to use, refer to the chrono strftime documentation for specification. Example: "%y-%m-%d".

Examples

>>> from datetime import datetime
>>> s = pl.Series(
...     "datetime",
...     [datetime(2020, 3, 1), datetime(2020, 4, 1), datetime(2020, 5, 1)],
... )
>>> s.dt.to_string("%Y/%m/%d")
shape: (3,)
Series: 'datetime' [str]
[
    "2020/03/01"
    "2020/04/01"
    "2020/05/01"
]

If you’re interested in the day name / month name, you can use '%A' / '%B':

>>> s.dt.to_string("%A")
shape: (3,)
Series: 'datetime' [str]
[
        "Sunday"
        "Wednesday"
        "Friday"
]

>>> s.dt.to_string("%B")
shape: (3,)
Series: 'datetime' [str]
[
        "March"
        "April"
        "May"
]