Source code for xpark.dataset.namespace_expressions.datetime_namespace

"""Datetime namespace for operations on datetime-typed expression columns."""

from __future__ import annotations

from dataclasses import dataclass

from ray.data.namespace_expressions.dt_namespace import _DatetimeNamespace as RayDatetimeNamespace




@dataclass
class _DatetimeNamespace(RayDatetimeNamespace):
    """Namespace for datetime operations on expression columns.

    This namespace provides methods for operating on datetime-typed columns using
    PyArrow compute functions.

    Example:
        >>> from xpark.dataset.expressions import col
        >>> # Extract year component
        >>> expr = col("datetime").dt.year
        >>> # Extract month component
        >>> expr = col("datetime").dt.month
        >>> # Extract day component
        >>> expr = col("datetime").dt.day
        >>> # Extract hour component
        >>> expr = col("datetime").dt.hour
        >>> # Extract minute component
        >>> expr = col("datetime").dt.minute
        >>> # Extract second component
        >>> expr = col("datetime").dt.second
    """