polars.Series.dt.total_seconds#

Series.dt.total_seconds(*, fractional: bool = False) → Series[source]#

Extract the total seconds from a Duration type.

Parameters:

fractional: Whether to include the fractional component of the second.

Returns:

Series: Series of data type Int64 or Float64 if fractional is set.

Examples

>>> from datetime import datetime
>>> date = pl.datetime_range(
...     datetime(2020, 1, 1), datetime(2020, 1, 1, 0, 4, 0), "1m", eager=True
... ).alias("datetime")
>>> date
shape: (5,)
Series: 'datetime' [datetime[μs]]
[
        2020-01-01 00:00:00
        2020-01-01 00:01:00
        2020-01-01 00:02:00
        2020-01-01 00:03:00
        2020-01-01 00:04:00
]
>>> date.diff().dt.total_seconds()
shape: (5,)
Series: 'datetime' [i64]
[
        null
        60
        60
        60
        60
]