df-script 1.9.0 → 2.0.0

package/dist/columnExpressions/mixins/TemporalExpr.d.ts

@@ -12,17 +12,17 @@ import { ExprBase } from "../ExprBase";
  * as `microsecond()` and `nanosecond()` always scale from milliseconds. Migrating to
  * raw `BigInt` arrays would be required for true sub-ms storage.
  *
- * _Timezone enforcement_: `convert_time_zone` can only validate that the column is
+ * _Timezone enforcement_: `convertTimeZone` can only validate that the column is
  * timezone-aware when `_castType` is explicitly set within the expression chain
- * (e.g. after `cast_time_unit`). Enforcement against a column whose type is unknown
+ * (e.g. after `castTimeUnit`). Enforcement against a column whose type is unknown
  * at expression-build time requires schema-level checks in DataFrame operations.
  */
 export declare class DateTimeExprNamespace {
     expr: any;
     constructor(expr: any);
-    /** Returns the column's schema timezone from a prior convert_time_zone call, or null. */
+    /** Returns the column's schema timezone from a prior convertTimeZone call, or null. */
     _colTz(): string | null;
-    /** Returns the column's schema time unit from a prior cast_time_unit call, or null. */
+    /** Returns the column's schema time unit from a prior castTimeUnit call, or null. */
     _colTu(): DatetimeTimeUnit | null;
     _deriveDate(fn: (d: Date) => any): any;
     /**
@@ -31,8 +31,15 @@ export declare class DateTimeExprNamespace {
      * @param unit Target time unit: `"ms"` (milliseconds), `"us"` (microseconds), or `"ns"` (nanoseconds).
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.123Z"] })
-     * >>> df.with_columns($df.col("ts").dt.cast_time_unit("us").alias("ts_us"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.castTimeUnit("us").alias("ts_us"))
      * shape: (1, 2)
      * ┌──────────────────────────┬──────────────────────────┐
      * │ ts                       │ ts_us                    │
@@ -40,13 +47,20 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20T10:00:00.123Z │ 2026-05-20T10:00:00.123Z │
      * └──────────────────────────┴──────────────────────────┘
      */
-    cast_time_unit(unit: DatetimeTimeUnit): any;
+    castTimeUnit(unit: DatetimeTimeUnit): any;
     /**
      * Extracts the 1-indexed century component (e.g. 21 for 2026) from a Datetime column.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.century().alias("century"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.century().alias("century"))
      * shape: (1, 2)
      * ┌────────────┬─────────┐
      * │ d          │ century │
@@ -54,38 +68,54 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 21      │
      * └────────────┴─────────┘
      */
-    century(): any;
+    century(timeZone?: string): any;
     /**
      * Converts a Datetime column to a different IANA timezone.
      * Preserves the exact UTC epoch instant while changing the timezone label, affecting
      * how local wall-clock component extractors (`hour()`, `day()`, etc.) and `strftime` interpret values.
      * Requires the column to already be timezone-aware; use `replace({ timeZone })`
      * to assign a timezone to a naive column first.
+     * @note [Timezone Compatibility]: Converting across named timezones relies on native `Intl.DateTimeFormat`
+     * IANA database resolution. Unrecognized timezones safely fallback to `"UTC"`.
      * @param timeZone Target IANA timezone identifier (e.g. `"UTC"`, `"America/New_York"`, `"Europe/London"`).
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-06-01T00:00:00.000Z"] })
-     * >>> df.with_columns($df.col("ts").dt.convert_time_zone("America/New_York").alias("ts_ny"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.replace({ timeZone: "UTC" }).dt.convertTimeZone("America/New_York").alias("ts_ny"))
      * shape: (1, 2)
      * ┌──────────────────────────┬───────────────────────────────┐
      * │ ts                       │ ts_ny                         │
      * ├──────────────────────────┼───────────────────────────────┤
-     * │ 2026-06-01T00:00:00.000Z │ 2026-05-31 20:00:00.000 EDT   │
+     * │ 2026-05-20T10:00:00.123Z │ 2026-05-20 06:00:00.123 EDT   │
      * └──────────────────────────┴───────────────────────────────┘
      */
-    convert_time_zone(timeZone: string): any;
+    convertTimeZone(timeZone: string): any;
     /**
      * Extracts the Date object component from a Datetime column, truncating time to 00:00:00.000 UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:30:00Z"] })
-     * >>> df.with_columns($df.col("ts").dt.date().alias("date_only"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.date().alias("date_only"))
      * shape: (1, 2)
-     * ┌──────────────────────┬──────────────────────────┐
-     * │ ts                   │ date_only                │
-     * ├──────────────────────┼──────────────────────────┤
-     * │ 2026-05-20T10:30:00Z │ 2026-05-20T00:00:00.000Z │
-     * └──────────────────────┴──────────────────────────┘
+     * ┌──────────────────────────┬──────────────────────────┐
+     * │ ts                       │ date_only                │
+     * ├──────────────────────────┼──────────────────────────┤
+     * │ 2026-05-20T10:00:00.123Z │ 2026-05-20T00:00:00.000Z │
+     * └──────────────────────────┴──────────────────────────┘
      */
     date(): any;
     /**
@@ -93,8 +123,15 @@ export declare class DateTimeExprNamespace {
      * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.day().alias("day"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.day().alias("day"))
      * shape: (1, 2)
      * ┌────────────┬─────┐
      * │ d          │ day │
@@ -108,29 +145,43 @@ export declare class DateTimeExprNamespace {
      * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2024-02-15"] })
-     * >>> df.with_columns($df.col("d").dt.days_in_month().alias("dim"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.daysInMonth().alias("dim"))
      * shape: (1, 2)
      * ┌────────────┬─────┐
      * │ d          │ dim │
      * ├────────────┼─────┤
-     * │ 2024-02-15 │ 29  │
+     * │ 2026-05-20 │ 31  │
      * └────────────┴─────┘
      */
-    days_in_month(timeZone?: string): any;
+    daysInMonth(timeZone?: string): any;
     /**
      * Returns the epoch duration timestamp offset in the specified time resolution unit.
      * @param unit Time resolution unit (`"ms"`, `"us"`, `"ns"`, `"s"`). Defaults to `"ms"`.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-01-01T00:00:00Z"] })
-     * >>> df.with_columns($df.col("d").dt.epoch("s").alias("epoch_s"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.epoch("s").alias("epoch_s"))
      * shape: (1, 2)
-     * ┌──────────────────────┬────────────┐
-     * │ d                    │ epoch_s    │
-     * ├──────────────────────┼────────────┤
-     * │ 2026-01-01T00:00:00Z │ 1767225600 │
-     * └──────────────────────┴────────────┘
+     * ┌────────────┬────────────┐
+     * │ d          │ epoch_s    │
+     * ├────────────┼────────────┤
+     * │ 2026-05-20 │ 1779235200 │
+     * └────────────┴────────────┘
      */
     epoch(unit?: TimeUnit): any;
     /**
@@ -138,14 +189,21 @@ export declare class DateTimeExprNamespace {
      * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T14:30:00Z"] })
-     * >>> df.with_columns($df.col("ts").dt.hour().alias("hr"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.hour().alias("hr"))
      * shape: (1, 2)
-     * ┌──────────────────────┬────┐
-     * │ ts                   │ hr │
-     * ├──────────────────────┼────┤
-     * │ 2026-05-20T14:30:00Z │ 14 │
-     * └──────────────────────┴────┘
+     * ┌──────────────────────────┬────┐
+     * │ ts                       │ hr │
+     * ├──────────────────────────┼────┤
+     * │ 2026-05-20T10:00:00.123Z │ 10 │
+     * └──────────────────────────┴────┘
      */
     hour(timeZone?: string): any;
     /**
@@ -154,37 +212,59 @@ export declare class DateTimeExprNamespace {
      * @param options Business day rules and custom holiday configuration options.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-18"] })
-     * >>> df.with_columns($df.col("d").dt.is_business_day().alias("is_bday"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.isBusinessDay().alias("is_bday"))
      * shape: (1, 2)
      * ┌────────────┬─────────┐
      * │ d          │ is_bday │
      * ├────────────┼─────────┤
-     * │ 2026-05-18 │ true    │
+     * │ 2026-05-20 │ true    │
      * └────────────┴─────────┘
      */
-    is_business_day(options?: IsBusinessDayOptions): any;
+    isBusinessDay(options?: IsBusinessDayOptions): any;
     /**
      * Checks if the calendar year of a Datetime value is a leap year (366 days).
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2024-01-01", "2026-01-01"] })
-     * >>> df.with_columns($df.col("d").dt.is_leap_year().alias("leap"))
-     * shape: (2, 2)
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.isLeapYear().alias("leap"))
+     * shape: (1, 2)
      * ┌────────────┬───────┐
      * │ d          │ leap  │
      * ├────────────┼───────┤
-     * │ 2024-01-01 │ true  │
-     * │ 2026-01-01 │ false │
+     * │ 2026-05-20 │ false │
      * └────────────┴───────┘
      */
-    is_leap_year(): any;
+    isLeapYear(timeZone?: string): any;
     /**
      * Extracts the ISO 8601 week number (1-53) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.iso_week().alias("week"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.isoWeek().alias("week"))
      * shape: (1, 2)
      * ┌────────────┬──────┐
      * │ d          │ week │
@@ -192,13 +272,21 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 21   │
      * └────────────┴──────┘
      */
-    iso_week(): any;
+    isoWeek(timeZone?: string): any;
     /**
      * Extracts the ISO 8601 week-numbering year from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.iso_year().alias("iso_yr"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.isoYear().alias("iso_yr"))
      * shape: (1, 2)
      * ┌────────────┬────────┐
      * │ d          │ iso_yr │
@@ -206,13 +294,21 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2026   │
      * └────────────┴────────┘
      */
-    iso_year(): any;
+    isoYear(timeZone?: string): any;
     /**
      * Extracts the microsecond component (0-999,000) scaled from Datetime millisecond precision.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.123Z"] })
-     * >>> df.with_columns($df.col("ts").dt.microsecond().alias("us"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.microsecond().alias("us"))
      * shape: (1, 2)
      * ┌──────────────────────────┬────────┐
      * │ ts                       │ us     │
@@ -220,13 +316,20 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20T10:00:00.123Z │ 123000 │
      * └──────────────────────────┴────────┘
      */
-    microsecond(): any;
+    microsecond(timeZone?: string): any;
     /**
      * Extracts the 1-indexed millennium component index (e.g. 3 for the year 2026) from a Datetime column.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.millennium().alias("mil"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.millennium().alias("mil"))
      * shape: (1, 2)
      * ┌────────────┬─────┐
      * │ d          │ mil │
@@ -234,34 +337,49 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 3   │
      * └────────────┴─────┘
      */
-    millennium(): any;
+    millennium(timeZone?: string): any;
     /**
      * Extracts the millisecond component (0-999) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.456Z"] })
-     * >>> df.with_columns($df.col("ts").dt.millisecond().alias("ms"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.millisecond().alias("ms"))
      * shape: (1, 2)
      * ┌──────────────────────────┬─────┐
      * │ ts                       │ ms  │
      * ├──────────────────────────┼─────┤
-     * │ 2026-05-20T10:00:00.456Z │ 456 │
+     * │ 2026-05-20T10:00:00.123Z │ 123 │
      * └──────────────────────────┴─────┘
      */
-    millisecond(): any;
+    millisecond(timeZone?: string): any;
     /**
      * Extracts the minute component (0-59) from a Datetime column.
      * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:45:00Z"] })
-     * >>> df.with_columns($df.col("ts").dt.minute().alias("min"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.minute().alias("min"))
      * shape: (1, 2)
-     * ┌──────────────────────┬─────┐
-     * │ ts                   │ min │
-     * ├──────────────────────┼─────┤
-     * │ 2026-05-20T10:45:00Z │ 45  │
-     * └──────────────────────┴─────┘
+     * ┌──────────────────────────┬─────┐
+     * │ ts                       │ min │
+     * ├──────────────────────────┼─────┤
+     * │ 2026-05-20T10:00:00.123Z │ 0   │
+     * └──────────────────────────┴─────┘
      */
     minute(timeZone?: string): any;
     /**
@@ -269,8 +387,15 @@ export declare class DateTimeExprNamespace {
      * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.month().alias("m"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.month().alias("m"))
      * shape: (1, 2)
      * ┌────────────┬───┐
      * │ d          │ m │
@@ -283,8 +408,15 @@ export declare class DateTimeExprNamespace {
      * Returns a Datetime column shifted to the last calendar day of the month at 00:00:00.000 UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.month_end().alias("m_end"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.monthEnd().alias("m_end"))
      * shape: (1, 2)
      * ┌────────────┬──────────────────────────┐
      * │ d          │ m_end                    │
@@ -292,13 +424,20 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2026-05-31T00:00:00.000Z │
      * └────────────┴──────────────────────────┘
      */
-    month_end(): any;
+    monthEnd(): any;
     /**
      * Returns a Datetime column shifted to the first calendar day of the month at 00:00:00.000 UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.month_start().alias("m_start"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.monthStart().alias("m_start"))
      * shape: (1, 2)
      * ┌────────────┬──────────────────────────┐
      * │ d          │ m_start                  │
@@ -306,21 +445,29 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2026-05-01T00:00:00.000Z │
      * └────────────┴──────────────────────────┘
      */
-    month_start(): any;
+    monthStart(): any;
     /**
      * Extracts the nanosecond component (0-999,000,000) scaled from Datetime millisecond precision.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:00:00.001Z"] })
-     * >>> df.with_columns($df.col("ts").dt.nanosecond().alias("ns"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.nanosecond().alias("ns"))
      * shape: (1, 2)
-     * ┌──────────────────────────┬─────────┐
-     * │ ts                       │ ns      │
-     * ├──────────────────────────┼─────────┤
-     * │ 2026-05-20T10:00:00.001Z │ 1000000 │
-     * └──────────────────────────┴─────────┘
+     * ┌──────────────────────────┬───────────┐
+     * │ ts                       │ ns        │
+     * ├──────────────────────────┼───────────┤
+     * │ 2026-05-20T10:00:00.123Z │ 123000000 │
+     * └──────────────────────────┴───────────┘
      */
-    nanosecond(): any;
+    nanosecond(timeZone?: string): any;
     /**
      * Offsets a Datetime column by N calendar days (numeric constant, column reference, or expression).
      * Reuses $df.duration({ days: n }) and expression addition math under the hood.
@@ -328,8 +475,15 @@ export declare class DateTimeExprNamespace {
      * @param options Day offset configuration options.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.offset_day(5).alias("later"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.offsetDay(5).alias("later"))
      * shape: (1, 2)
      * ┌────────────┬──────────────────────────┐
      * │ d          │ later                    │
@@ -337,27 +491,43 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2026-05-25T00:00:00.000Z │
      * └────────────┴──────────────────────────┘
      */
-    offset_day(n: number | any, options?: DayOffsetOptions): any;
+    offsetDay(n: number | any, options?: DayOffsetOptions): any;
     /**
      * Extracts the day of the year (1-366) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-02-01"] })
-     * >>> df.with_columns($df.col("d").dt.ordinal_day().alias("doy"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.ordinalDay().alias("doy"))
      * shape: (1, 2)
      * ┌────────────┬─────┐
      * │ d          │ doy │
      * ├────────────┼─────┤
-     * │ 2026-02-01 │ 32  │
+     * │ 2026-05-20 │ 140 │
      * └────────────┴─────┘
      */
-    ordinal_day(): any;
+    ordinalDay(timeZone?: string): any;
     /**
      * Extracts the calendar quarter of the year (1-4) from a Datetime column.
+     * @param timeZone Optional IANA timezone identifier. Defaults to UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.quarter().alias("qtr"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.quarter().alias("qtr"))
      * shape: (1, 2)
      * ┌────────────┬─────┐
      * │ d          │ qtr │
@@ -365,7 +535,7 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 2   │
      * └────────────┴─────┘
      */
-    quarter(): any;
+    quarter(timeZone?: string): any;
     /**
      * Replaces specific date and time components (`year`, `month`, `day`, `hour`, `minute`, `second`, `ms`, `timeZone`) of a Datetime column.
      * Unspecified components are preserved from the original value.
@@ -374,38 +544,61 @@ export declare class DateTimeExprNamespace {
      * @param options Object specifying which components to replace.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T14:30:00Z"] })
-     * >>> df.with_columns($df.col("ts").dt.replace({ year: 2030, month: 1, day: 1 }).alias("replaced"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.replace({ year: 2030, month: 1, day: 1 }).alias("replaced"))
      * shape: (1, 2)
-     * ┌──────────────────────┬──────────────────────────┐
-     * │ ts                   │ replaced                 │
-     * ├──────────────────────┼──────────────────────────┤
-     * │ 2026-05-20T14:30:00Z │ 2030-01-01T14:30:00.000Z │
-     * └──────────────────────┴──────────────────────────┘
+     * ┌──────────────────────────┬──────────────────────────┐
+     * │ ts                       │ replaced                 │
+     * ├──────────────────────────┼──────────────────────────┤
+     * │ 2026-05-20T10:00:00.123Z │ 2030-01-01T10:00:00.123Z │
+     * └──────────────────────────┴──────────────────────────┘
      */
     replace(options: ReplaceDateOptions): any;
     /**
      * Extracts the second component (0-59) from a Datetime column.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:00:45Z"] })
-     * >>> df.with_columns($df.col("ts").dt.second().alias("sec"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.second().alias("sec"))
      * shape: (1, 2)
-     * ┌──────────────────────┬─────┐
-     * │ ts                   │ sec │
-     * ├──────────────────────┼─────┤
-     * │ 2026-05-20T10:00:45Z │ 45  │
-     * └──────────────────────┴─────┘
+     * ┌──────────────────────────┬─────┐
+     * │ ts                       │ sec │
+     * ├──────────────────────────┼─────┤
+     * │ 2026-05-20T10:00:00.123Z │ 0   │
+     * └──────────────────────────┴─────┘
      */
     second(): any;
     /**
      * Formats Datetime values into custom formatted strings using strftime directive pattern tokens.
      * Automatically applies the column's assigned timezone unless explicitly overridden in options.
+     * @note [Timezone Compatibility]: Timezone-aware formatting relies on native `Intl.DateTimeFormat`
+     * timezone resolution. If an invalid or unsupported IANA timezone is provided, formatting safely defaults to `"UTC"`.
      * @param options Formatting pattern string (e.g. `"%Y-%m-%d %H:%M:%S"`) or configuration object.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.strftime("%Y/%m/%d").alias("formatted"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.strftime("%Y/%m/%d").alias("formatted"))
      * shape: (1, 2)
      * ┌────────────┬────────────┐
      * │ d          │ formatted  │
@@ -418,14 +611,21 @@ export declare class DateTimeExprNamespace {
      * Extracts the time component formatted string (`"HH:MM:SS.mmm"`) from a Datetime column.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ ts: ["2026-05-20T10:30:00Z"] })
-     * >>> df.with_columns($df.col("ts").dt.time().alias("time"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("ts").dt.time().alias("time"))
      * shape: (1, 2)
-     * ┌──────────────────────┬──────────────┐
-     * │ ts                   │ time         │
-     * ├──────────────────────┼──────────────┤
-     * │ 2026-05-20T10:30:00Z │ 10:30:00.000 │
-     * └──────────────────────┴──────────────┘
+     * ┌──────────────────────────┬──────────────┐
+     * │ ts                       │ time         │
+     * ├──────────────────────────┼──────────────┤
+     * │ 2026-05-20T10:00:00.123Z │ 10:00:00.123 │
+     * └──────────────────────────┴──────────────┘
      */
     time(): any;
     /**
@@ -433,114 +633,177 @@ export declare class DateTimeExprNamespace {
      * @param unit Time unit resolution.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-01-01T00:00:00Z"] })
-     * >>> df.with_columns($df.col("d").dt.timestamp("s").alias("ts"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.timestamp("s").alias("ts"))
      * shape: (1, 2)
-     * ┌──────────────────────┬────────────┐
-     * │ d                    │ ts         │
-     * ├──────────────────────┼────────────┤
-     * │ 2026-01-01T00:00:00Z │ 1767225600 │
-     * └──────────────────────┴────────────┘
+     * ┌────────────┬────────────┐
+     * │ d          │ ts         │
+     * ├────────────┼────────────┤
+     * │ 2026-05-20 │ 1779235200 │
+     * └────────────┴────────────┘
      */
     timestamp(unit?: TimeUnit): any;
     /**
      * Converts a Duration value (in milliseconds) to total days count.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [86400000] })
-     * >>> df.with_columns($df.col("dur").dt.total_days().alias("days"))
-     * shape: (1, 2)
-     * ┌──────────┬──────┐
-     * │ dur      │ days │
-     * ├──────────┼──────┤
-     * │ 86400000 │ 1    │
-     * └──────────┴──────┘
-     */
-    total_days(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalDays().alias("days"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬──────┐
+     * │ dt         │ add │ days │
+     * ├────────────┼─────┼──────┤
+     * │ 2026-01-01 │ 1   │ 1    │
+     * │ 2026-01-01 │ 2   │ 2    │
+     * └────────────┴─────┴──────┘
+     */
+    totalDays(): any;
     /**
      * Converts a Duration value (in milliseconds) to total hours count.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [3600000] })
-     * >>> df.with_columns($df.col("dur").dt.total_hours().alias("hrs"))
-     * shape: (1, 2)
-     * ┌─────────┬─────┐
-     * │ dur     │ hrs │
-     * ├─────────┼─────┤
-     * │ 3600000 │ 1   │
-     * └─────────┴─────┘
-     */
-    total_hours(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalHours().alias("hrs"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬─────┐
+     * │ dt         │ add │ hrs │
+     * ├────────────┼─────┼─────┤
+     * │ 2026-01-01 │ 1   │ 24  │
+     * │ 2026-01-01 │ 2   │ 48  │
+     * └────────────┴─────┴─────┘
+     */
+    totalHours(): any;
     /**
      * Converts Duration to microsecond count.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [10] })
-     * >>> df.with_columns($df.col("dur").dt.total_microseconds().alias("us"))
-     * shape: (1, 2)
-     * ┌─────┬───────┐
-     * │ dur │ us    │
-     * ├─────┼───────┤
-     * │ 10  │ 10000 │
-     * └─────┴───────┘
-     */
-    total_microseconds(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalMicroseconds().alias("us"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬──────────────┐
+     * │ dt         │ add │ us           │
+     * ├────────────┼─────┼──────────────┤
+     * │ 2026-01-01 │ 1   │ 86400000000  │
+     * │ 2026-01-01 │ 2   │ 172800000000 │
+     * └────────────┴─────┴──────────────┘
+     */
+    totalMicroseconds(): any;
     /**
      * Converts Duration to millisecond count.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [500] })
-     * >>> df.with_columns($df.col("dur").dt.total_milliseconds().alias("ms"))
-     * shape: (1, 2)
-     * ┌─────┬─────┐
-     * │ dur │ ms  │
-     * ├─────┼─────┤
-     * │ 500 │ 500 │
-     * └─────┴─────┘
-     */
-    total_milliseconds(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalMilliseconds().alias("ms"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬───────────┐
+     * │ dt         │ add │ ms        │
+     * ├────────────┼─────┼───────────┤
+     * │ 2026-01-01 │ 1   │ 86400000  │
+     * │ 2026-01-01 │ 2   │ 172800000 │
+     * └────────────┴─────┴───────────┘
+     */
+    totalMilliseconds(): any;
     /**
      * Converts Duration to floating point minutes.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [60000] })
-     * >>> df.with_columns($df.col("dur").dt.total_minutes().alias("mins"))
-     * shape: (1, 2)
-     * ┌───────┬──────┐
-     * │ dur   │ mins │
-     * ├───────┼──────┤
-     * │ 60000 │ 1    │
-     * └───────┴──────┘
-     */
-    total_minutes(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalMinutes().alias("mins"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬──────┐
+     * │ dt         │ add │ mins │
+     * ├────────────┼─────┼──────┤
+     * │ 2026-01-01 │ 1   │ 1440 │
+     * │ 2026-01-01 │ 2   │ 2880 │
+     * └────────────┴─────┴──────┘
+     */
+    totalMinutes(): any;
     /**
      * Converts Duration to nanosecond count.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [1] })
-     * >>> df.with_columns($df.col("dur").dt.total_nanoseconds().alias("ns"))
-     * shape: (1, 2)
-     * ┌─────┬─────────┐
-     * │ dur │ ns      │
-     * ├─────┼─────────┤
-     * │ 1   │ 1000000 │
-     * └─────┴─────────┘
-     */
-    total_nanoseconds(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalNanoseconds().alias("ns"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬─────────────────┐
+     * │ dt         │ add │ ns              │
+     * ├────────────┼─────┼─────────────────┤
+     * │ 2026-01-01 │ 1   │ 86400000000000  │
+     * │ 2026-01-01 │ 2   │ 172800000000000 │
+     * └────────────┴─────┴─────────────────┘
+     */
+    totalNanoseconds(): any;
     /**
      * Converts Duration to floating point seconds.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ dur: [1000] })
-     * >>> df.with_columns($df.col("dur").dt.total_seconds().alias("secs"))
-     * shape: (1, 2)
-     * ┌──────┬──────┐
-     * │ dur  │ secs │
-     * ├──────┼──────┤
-     * │ 1000 │ 1    │
-     * └──────┴──────┘
-     */
-    total_seconds(): any;
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.duration({ days: $df.col("add") }).dt.totalSeconds().alias("secs"))
+     * shape: (2, 3)
+     * ┌────────────┬─────┬────────┐
+     * │ dt         │ add │ secs   │
+     * ├────────────┼─────┼────────┤
+     * │ 2026-01-01 │ 1   │ 86400  │
+     * │ 2026-01-01 │ 2   │ 172800 │
+     * └────────────┴─────┴────────┘
+     */
+    totalSeconds(): any;
     /**
      * Returns the UTC offset of a timezone for a given Datetime value.
      * Supports returning the total offset, the standard (base) offset, or just the
@@ -551,8 +814,15 @@ export declare class DateTimeExprNamespace {
      *   output unit (`"milliseconds"` | `"minutes"` | `"hours"` | `"iso"` | `"basic"`).
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.utc_offset("UTC").alias("offset"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.utcOffset("UTC").alias("offset"))
      * shape: (1, 2)
      * ┌────────────┬────────┐
      * │ d          │ offset │
@@ -560,13 +830,21 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 0      │
      * └────────────┴────────┘
      */
-    utc_offset(timeZone?: string, options?: UtcOffsetOptions): any;
+    utcOffset(timeZone?: string, options?: UtcOffsetOptions): any;
     /**
-     * Extracts ISO week index. Alias for iso_week.
+     * Extracts ISO week index. Alias for isoWeek.
+     * @param timeZone Optional IANA timezone identifier. Defaults to the column timezone or UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.week().alias("week"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.week().alias("week"))
      * shape: (1, 2)
      * ┌────────────┬──────┐
      * │ d          │ week │
@@ -574,19 +852,26 @@ export declare class DateTimeExprNamespace {
      * │ 2026-05-20 │ 21   │
      * └────────────┴──────┘
      */
-    week(): any;
+    week(timeZone?: string): any;
     /**
      * Extracts weekday component (1=Monday, 7=Sunday).
      * @param timeZone Optional IANA timezone identifier. Defaults to UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-18"] })
-     * >>> df.with_columns($df.col("d").dt.weekday().alias("wd"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.weekday().alias("wd"))
      * shape: (1, 2)
      * ┌────────────┬────┐
      * │ d          │ wd │
      * ├────────────┼────┤
-     * │ 2026-05-18 │ 1  │
+     * │ 2026-05-20 │ 3  │
      * └────────────┴────┘
      */
     weekday(timeZone?: string): any;
@@ -595,8 +880,15 @@ export declare class DateTimeExprNamespace {
      * @param timeZone Optional IANA timezone identifier. Defaults to UTC.
      * @returns ColumnExpression
      * @example
-     * >>> const df = $df.data({ d: ["2026-05-20"] })
-     * >>> df.with_columns($df.col("d").dt.year().alias("yr"))
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
+     * >>> df.withColumns($df.col("d").dt.year().alias("yr"))
      * shape: (1, 2)
      * ┌────────────┬──────┐
      * │ d          │ yr   │
@@ -614,7 +906,21 @@ export declare class TemporalExpr extends ExprBase {
      * @syntax $df.col(<column_name>).dt
      * @returns DateTimeExprNamespace
      * @example
+ * >>> const df = $df.data({ date: ["2026-05-20T10:00:00.123Z"] })
+ * >>> df
+ * shape: (1, 1)
+ * ┌──────────────────────────┐
+ * │ date                     │
+ * ├──────────────────────────┤
+ * │ 2026-05-20T10:00:00.123Z │
+ * └──────────────────────────┘
      * >>> df.select($df.col("date").dt.year())
+     * shape: (1, 1)
+     * ┌──────┐
+     * │ year │
+     * ├──────┤
+     * │ 2026 │
+     * └──────┘
      */
     get dt(): DateTimeExprNamespace;
 }