polars.Expr.dt.microseconds

Expr.dt.microseconds() → Expr

Extract the microseconds from a Duration type.

Returns:

A series of dtype Int64

Examples

>>> from datetime import datetime
>>> df = pl.DataFrame(
...     {
...         "date": pl.date_range(
...             datetime(2020, 1, 1), datetime(2020, 1, 1, 0, 0, 1, 0), "1ms"
...         ),
...     }
... )
>>> df.select(
...     [
...         pl.col("date"),
...         pl.col("date").diff().dt.microseconds().alias("microseconds_diff"),
...     ]
... )
shape: (1001, 2)
┌─────────────────────────┬───────────────────┐
│ date                    ┆ microseconds_diff │
│ ---                     ┆ ---               │
│ datetime[μs]            ┆ i64               │
╞═════════════════════════╪═══════════════════╡
│ 2020-01-01 00:00:00     ┆ null              │
│ 2020-01-01 00:00:00.001 ┆ 1000              │
│ 2020-01-01 00:00:00.002 ┆ 1000              │
│ 2020-01-01 00:00:00.003 ┆ 1000              │
│ …                       ┆ …                 │
│ 2020-01-01 00:00:00.997 ┆ 1000              │
│ 2020-01-01 00:00:00.998 ┆ 1000              │
│ 2020-01-01 00:00:00.999 ┆ 1000              │
│ 2020-01-01 00:00:01     ┆ 1000              │
└─────────────────────────┴───────────────────┘