daft.functions.convert_time_zone#

def convert_time_zone(expr: Expression, to_timezone: str, from_timezone: str | None = None) -> Expression:
    """Converts a timestamp to another timezone while preserving the instant in time.

    If the timestamp has no timezone, `from_timezone` must be provided to interpret the local time before converting to `to_timezone`.

    Args:
        expr: Timestamp expression to convert.
        to_timezone: Target timezone (e.g. "UTC", "+02:00", "America/New_York").
        from_timezone: Source timezone for timestamps without a timezone.

    Returns:
        Expression: Timestamp expression with the target timezone.
    """
    return Expression._call_builtin_scalar_fn("convert_time_zone", expr, to_timezone, from_timezone)