Skip to content

timestamp

Source code

Description

Return a timestamp in the given time unit.

Usage

<Expr>$dt$timestamp(tu = c("ns", "us", "ms"))

Arguments

tu string option either ‘ns’, ‘us’, or ‘ms’

Value

Expr of i64

Examples

library("polars")

df = pl$DataFrame(
  date = pl$datetime_range(
    start = as.Date("2001-1-1"),
    end = as.Date("2001-1-3"),
    interval = "1d1s"
  )
)
df$select(
  pl$col("date"),
  pl$col("date")$dt$timestamp()$alias("timestamp_ns"),
  pl$col("date")$dt$timestamp(tu = "ms")$alias("timestamp_ms")
)

#> shape: (2, 3)
#> ┌─────────────────────┬────────────────────┬──────────────┐
#> │ date                ┆ timestamp_ns       ┆ timestamp_ms │
#> │ ---                 ┆ ---                ┆ ---          │
#> │ datetime[μs]        ┆ i64                ┆ i64          │
#> ╞═════════════════════╪════════════════════╪══════════════╡
#> │ 2001-01-01 00:00:00 ┆ 978307200000000000 ┆ 978307200000 │
#> │ 2001-01-02 00:00:01 ┆ 978393601000000000 ┆ 978393601000 │
#> └─────────────────────┴────────────────────┴──────────────┘