daft.functions.from_unixtime#

def from_unixtime(expr: Expression, format: str | None = None) -> Expression:
    """Converts a Unix timestamp (seconds) to a formatted string.

    Args:
        expr: A numeric expression representing seconds since epoch.
        format: Optional strftime format string. Defaults to '%Y-%m-%d %H:%M:%S'.

    Returns:
        Expression: a Utf8 expression with the formatted timestamp.

    Examples:
        >>> import daft
        >>> from daft.functions import from_unixtime
        >>> df = daft.from_pydict({"s": [0, 1609459200]})
        >>> df = df.with_column("formatted", from_unixtime(df["s"]))
        >>> df.schema()["formatted"].dtype == daft.DataType.string()
        True
    """
    if format is not None:
        return Expression._call_builtin_scalar_fn("from_unixtime", expr, format=format)
    return Expression._call_builtin_scalar_fn("from_unixtime", expr)