next-execution

Elena Kostyuchenko

Definition

Gets time and date of the next DAG execution. Returns one execution unless the --num-executions option is provided.

Usage

$ airflow dags next-execution [-h] [-n NUM_EXECUTIONS] [-S SUBDIR] [-v] dag_id

Arguments

Parameter Description

dag_id

The ID of the DAG

-n, --num-executions

The number of next execution dates to show. Default: 1

-S, --subdir

File or directory location of the DAG. Defaults to [AIRFLOW_HOME]/dags, where [AIRFLOW_HOME] is the value set for AIRFLOW_HOME in airflow.cfg

-h, --help

Print out the help manual for this command

-v, --verbose

Make logging output more verbose

Examples

To get the date of the next DAG execution, run:

$ airflow dags next-execution adcm_check

Output example:

[INFO] Please be reminded this DAG is PAUSED now.
2025-04-04T04:37:12.246784+00:00
Found a mistake? Seleсt text and press Ctrl+Enter to report it