Skip to content

daft.functions.timestamp_micros#

timestamp_micros #

timestamp_micros(expr: Expression) -> Expression

Creates a timestamp from microseconds since Unix epoch.

Parameters:

Name Type Description Default
expr Expression

A numeric expression representing microseconds since epoch.

required

Returns:

Name Type Description
Expression Expression

a Timestamp[us] expression.

Examples:

1
2
3
4
5
>>> import daft
>>> from daft.functions import timestamp_micros
>>> df = daft.from_pydict({"us": [0, 1609459200000000]})
>>> df = df.with_column("ts", timestamp_micros(df["us"]))
>>> df.schema()["ts"].dtype == daft.DataType.timestamp("us")
True
Source code in daft/functions/datetime.py
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
def timestamp_micros(expr: Expression) -> Expression:
    """Creates a timestamp from microseconds since Unix epoch.

    Args:
        expr: A numeric expression representing microseconds since epoch.

    Returns:
        Expression: a Timestamp[us] expression.

    Examples:
        >>> import daft
        >>> from daft.functions import timestamp_micros
        >>> df = daft.from_pydict({"us": [0, 1609459200000000]})
        >>> df = df.with_column("ts", timestamp_micros(df["us"]))
        >>> df.schema()["ts"].dtype == daft.DataType.timestamp("us")
        True
    """
    return Expression._call_builtin_scalar_fn("timestamp_micros", expr)