docs(cron): add dst description

Signed-off-by: Tianchu Zhao <evantczhao@gmail.com>
argoproj · Apr 15, 2021 · a058f71 · a058f71
1 parent bf5d7bf
commit a058f71
Showing 1 changed file with 33 additions and 0 deletions.
diff --git a/docs/cron-workflows.md b/docs/cron-workflows.md
@@ -61,6 +61,39 @@ Currently only a single instance will be executed as a result of setting `starti
 
 This setting can also be configured in tandem with `concurrencyPolicy` to achieve more fine-tuned control.
 
+### Daylight Saving
+
+Daylight Saving (DST) is taking into account when using timezone. This guarantees argo only schedule workflow once when the clock moves forward or back.
+
+For example, with timezone set at `America/Los_Angeles`, we have daylight saving 
+- +1 hour (DST start) 2020-03-08 02:00:00
+
+| cron | sequence | workflow execution time |
+|------------|----------|-------------------------------|
+| 59 1 * * * | 1 | 2020-03-08 01:59:00 -0800 PST |
+| | 2 | 2020-03-09 01:59:00 -0700 PDT |
+| | 3 | 2020-03-10 01:59:00 -0700 PDT |
+| 0 2 * * * | 1 | 2020-03-09 02:00:00 -0700 PDT |
+| | 2 | 2020-03-10 02:00:00 -0700 PDT |
+| | 3 | 2020-03-11 02:00:00 -0700 PDT |
+| 1 2 * * * | 1 | 2020-03-09 02:01:00 -0700 PDT |
+| | 2 | 2020-03-10 02:01:00 -0700 PDT |
+| | 3 | 2020-03-11 02:01:00 -0700 PDT |
+
+- -1 hour (DST end) 2020-11-01 02:00:00
+
+| cron | sequence | workflow execution time |
+|------------|----------|-------------------------------|
+| 59 1 * * * | 1 | 2020-11-01 01:59:00 -0700 PDT |
+| | 2 | 2020-11-01 01:59:00 -0800 PST |
+| | 3 | 2020-11-02 01:59:00 -0800 PST |
+| 0 2 * * * | 1 | 2020-11-01 02:00:00 -0800 PST |
+| | 2 | 2020-11-02 02:00:00 -0800 PST |
+| | 3 | 2020-11-03 02:00:00 -0800 PST |
+| 1 2 * * * | 1 | 2020-11-01 02:01:00 -0800 PST |
+| | 2 | 2020-11-02 02:01:00 -0800 PST |
+| | 3 | 2020-11-03 02:01:00 -0800 PST |
+
 ## Managing `CronWorkflow`
 
 ### CLI