daft.functions.date_sub#

def date_sub(expr: Expression, days: Expression) -> Expression:
    """Subtracts a number of days from a date.

    Args:
        expr: A date expression.
        days: An integer expression representing the number of days to subtract.

    Returns:
        Expression: a Date expression.

    Examples:
        >>> import daft
        >>> from daft.functions import date_sub
        >>> df = daft.from_pydict({"d": ["2021-01-10", "2021-06-15"], "n": [5, 10]})
        >>> df = df.with_column("d", df["d"].cast(daft.DataType.date()))
        >>> df = df.with_column("result", date_sub(df["d"], df["n"]))
        >>> df.schema()["result"].dtype == daft.DataType.date()
        True
    """
    return Expression._call_builtin_scalar_fn("date_sub", expr, days)