[AIRFLOW-6320] Add quarterly to crontab presets (apache#6873)

FlyrInc · Mar 5, 2020 · 6bd8da3 · 6bd8da3
1 parent 98f1c7a
commit 6bd8da3
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 18 deletions.
diff --git a/airflow/utils/dates.py b/airflow/utils/dates.py
@@ -29,6 +29,7 @@
     '@daily': '0 0 * * *',
     '@weekly': '0 0 * * 0',
     '@monthly': '0 0 1 * *',
+    '@quarterly': '0 0 1 */3 *',
     '@yearly': '0 0 1 1 *',
 }
 

diff --git a/docs/dag-run.rst b/docs/dag-run.rst
@@ -30,24 +30,26 @@ a ``str``, or a ``datetime.timedelta`` object.
 
 Alternatively, you can also use one of these cron "presets":
 
-+--------------+----------------------------------------------------------------+---------------+
-| preset       | meaning                                                        | cron          |
-+==============+================================================================+===============+
-| ``None``     | Don't schedule, use for exclusively "externally triggered"     |               |
-|              | DAGs                                                           |               |
-+--------------+----------------------------------------------------------------+---------------+
-| ``@once``    | Schedule once and only once                                    |               |
-+--------------+----------------------------------------------------------------+---------------+
-| ``@hourly``  | Run once an hour at the beginning of the hour                  | ``0 * * * *`` |
-+--------------+----------------------------------------------------------------+---------------+
-| ``@daily``   | Run once a day at midnight                                     | ``0 0 * * *`` |
-+--------------+----------------------------------------------------------------+---------------+
-| ``@weekly``  | Run once a week at midnight on Sunday morning                  | ``0 0 * * 0`` |
-+--------------+----------------------------------------------------------------+---------------+
-| ``@monthly`` | Run once a month at midnight of the first day of the month     | ``0 0 1 * *`` |
-+--------------+----------------------------------------------------------------+---------------+
-| ``@yearly``  | Run once a year at midnight of January 1                       | ``0 0 1 1 *`` |
-+--------------+----------------------------------------------------------------+---------------+
++----------------+----------------------------------------------------------------+-----------------+
+| preset         | meaning                                                        | cron            |
++================+================================================================+=================+
+| ``None``       | Don't schedule, use for exclusively "externally triggered"     |                 |
+|                | DAGs                                                           |                 |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@once``      | Schedule once and only once                                    |                 |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@hourly``    | Run once an hour at the beginning of the hour                  | ``0 * * * *``   |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@daily``     | Run once a day at midnight                                     | ``0 0 * * *``   |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@weekly``    | Run once a week at midnight on Sunday morning                  | ``0 0 * * 0``   |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@monthly``   | Run once a month at midnight of the first day of the month     | ``0 0 1 * *``   |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@quarterly`` | Run once a quarter at midnight on the first day                | ``0 0 1 */3 *`` |
++----------------+----------------------------------------------------------------+-----------------+
+| ``@yearly``    | Run once a year at midnight of January 1                       | ``0 0 1 1 *``   |
++----------------+----------------------------------------------------------------+-----------------+
 
 Your DAG will be instantiated for each schedule along with a corresponding 
 DAG Run entry in the database backend.