From a058f7141be07af1f5a272bf812d8fe55e512cca Mon Sep 17 00:00:00 2001 From: Tianchu Zhao Date: Thu, 15 Apr 2021 16:14:15 +1000 Subject: [PATCH] docs(cron): add dst description Signed-off-by: Tianchu Zhao --- docs/cron-workflows.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/cron-workflows.md b/docs/cron-workflows.md index 71c5ee4df6a9..2ef4d669714e 100644 --- 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