ConstDuration / New Layer

Create a new column with a constant duration value (fixed time interval). Similar to Rust's std::time::Duration, Arrow's Duration type, or pandas Timedelta. Represents an exact time span (e.g., '24 hours') rather than calendar-relative time (e.g., '1 day' which can vary with DST). For calendar-relative durations, use date/time offset operations instead.

Table

TimeUnit

enum

Storage precision for the duration, following Arrow's Duration type granularity options.

Ns ~

Nanosecond precision (10^-9 seconds). Equivalent to Arrow's TimeUnit::NANO

Us ~

Microsecond precision (10^-6 seconds). Equivalent to Arrow's TimeUnit::MICRO

Ms ~

Millisecond precision (10^-3 seconds). Equivalent to Arrow's TimeUnit::MILLI

DurationValue

[, ...]

Component of a duration specification. Similar to Rust's Duration construction or Arrow's duration building blocks.

DurationUnit

enum

Nanoseconds

Unit for specifying duration components. Similar to Rust's Duration::from_* methods or pandas Timedelta units. Each unit can be used once; if repeated, the last value takes precedence.

Nanoseconds ~

Nanoseconds (ns). Smallest supported unit, 10^-9 seconds

Microseconds ~

Microseconds (μs). 10^-6 seconds

Milliseconds ~

Milliseconds (ms). 10^-3 seconds

Seconds ~

Seconds (s). Base unit for time measurements

Minutes ~

Minutes (min). 60 seconds

Hours ~

Hours (h). 3600 seconds

Days ~

Days (d). Exactly 24 hours (86400 seconds), regardless of DST

Weeks ~

Weeks (w). Exactly 7 days (604800 seconds)

Value

i64

Quantity of the specified unit. Can be negative for representing negative durations.

AsColumn

name

Name for the new column. If not provided, the system generates a unique name. If AsColumn matches an existing column, the existing column is replaced. The name should follow valid column naming conventions.