atoti.function.date_diff module#

atoti.date_diff(from_date, to_date, /, *, unit='days')#

Return a measure equal to the difference between two dates.

If one of the date is N/A then None is returned.

Parameters

  • from_date (_DateOrNonConstantMeasureConvertible) – The first date measure or object.

  • to_date (_DateOrNonConstantMeasureConvertible) – The second date measure or object.

  • unit (Literal['seconds', 'minutes', 'hours', 'days', 'weeks', 'months', 'years']) – The difference unit. Seconds, minutes and hours are only allowed if the dates contain time information.

Return type

MeasureDescription

Example

>>> from datetime import date
>>> df = pd.DataFrame(
...     columns=["From", "To"],
...     data=[
...         (date(2020, 1, 1), date(2020, 1, 2)),
...         (date(2020, 2, 1), date(2020, 2, 21)),
...         (date(2020, 3, 20), None),
...         (date(2020, 5, 15), date(2020, 4, 15)),
...     ],
... )
>>> table = session.read_pandas(
...     df, table_name="date_diff example", default_values={"To": "N/A"}
... )
>>> cube = session.create_cube(table)
>>> l, m = cube.levels, cube.measures
>>> m["Diff"] = tt.date_diff(l["From"], l["To"])
>>> cube.query(m["Diff"], m["contributors.COUNT"], levels=[l["From"], l["To"]])
                      Diff contributors.COUNT
From       To
2020-01-01 2020-01-02    1                  1
2020-02-01 2020-02-21   20                  1
2020-03-20 N/A                              1
2020-05-15 2020-04-15  -30                  1