Airflow Summit 2025 is coming October 07-09. Register now for early bird ticket!

TimeDeltaSensor

Use the TimeDeltaSensor to end sensing after specific time.

airflow/providers/standard/example_dags/example_sensors.py[source]

t0 = TimeDeltaSensor(task_id="wait_some_seconds", delta=datetime.timedelta(seconds=2))

TimeDeltaSensorAsync

Use the TimeDeltaSensorAsync to end sensing after specific time. It is an async version of the operator and requires Triggerer to run.

airflow/providers/standard/example_dags/example_sensors.py[source]

t0a = TimeDeltaSensor(
    task_id="wait_some_seconds_async", delta=datetime.timedelta(seconds=2), deferrable=True
)

TimeSensor

Use the TimeSensor to end sensing after time specified. TimeSensor can be run in deferrable mode, if a Triggerer is available.

Time will be evaluated against data_interval_end if present for the dag run, otherwise run_after will be used.

airflow/providers/standard/example_dags/example_sensors.py[source]

t1 = TimeSensor(
    task_id="fire_immediately", target_time=datetime.datetime.now(tz=datetime.timezone.utc).time()
)

t2 = TimeSensor(
    task_id="timeout_after_second_date_in_the_future",
    timeout=1,
    soft_fail=True,
    target_time=(datetime.datetime.now(tz=datetime.timezone.utc) + datetime.timedelta(hours=1)).time(),
)

t1a = TimeSensor(
    task_id="fire_immediately_async",
    target_time=datetime.datetime.now(tz=datetime.timezone.utc).time(),
    deferrable=True,
)

t2a = TimeSensor(
    task_id="timeout_after_second_date_in_the_future_async",
    timeout=1,
    soft_fail=True,
    target_time=(datetime.datetime.now(tz=datetime.timezone.utc) + datetime.timedelta(hours=1)).time(),
    deferrable=True,
)

DayOfWeekSensor

Use the DayOfWeekSensor to sense for day of week.

airflow/providers/standard/example_dags/example_sensors.py[source]

t11 = DayOfWeekSensor(
    task_id="week_day_sensor_failing_on_timeout", timeout=3, soft_fail=True, week_day=WeekDay.MONDAY
)

Was this entry helpful?