diff --git a/docs/user-manuals/advancedcronjob.md b/docs/user-manuals/advancedcronjob.md index 489054e08..688c9a872 100644 --- a/docs/user-manuals/advancedcronjob.md +++ b/docs/user-manuals/advancedcronjob.md @@ -52,3 +52,15 @@ spec: ``` The YAML below defines an AdvancedCronJob. It will create a BroadcastJob every minute, which will run a job on every node. + +## Time zones + +All CronJob schedule: times are based on the timezone of the kruise-controller-manager by default, +which means the timezone set for the kruise-controller-manager container determines the timezone that the cron job controller uses. + +**FEATURE STATE:** Kruise v1.3.0 + +However, we have introduce a `spec.timeZone` field in v1.3.0. +You can set it to the name of a valid time zone name. For example, setting `spec.timeZone: "Etc/UTC"` instructs Kruise to interpret the schedule relative to Coordinated Universal Time. + +A time zone database from the Go standard library is included in the binaries and used as a fallback in case an external database is not available on the system. diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/user-manuals/advancedcronjob.md b/i18n/zh/docusaurus-plugin-content-docs/current/user-manuals/advancedcronjob.md index c1553a9bb..3edd076bc 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/user-manuals/advancedcronjob.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/user-manuals/advancedcronjob.md @@ -52,3 +52,13 @@ spec: ``` 上述 YAML 定义了一个 AdvancedCronJob,每分钟创建一个 BroadcastJob 对象,这个 BroadcastJob 会在所有节点上运行一个 job 任务。 + +## 时区 + +默认情况下,所有 AdvancedCronJob schedule 调度时,都是基于 kruise-controller-manager 容器本地的时区所计算的。 + +**FEATURE STATE:** Kruise v1.3.0 + +不过,在 v1.3.0 版本中我们引入了 `spec.timeZone` 字段,你可以将它设置为任意合法时区的名字。例如,设置 `spec.timeZone: "Asia/Shanghai"` 则 Kruise 会根据国内的时区计算 schedule 任务触发时间。 + +Go 标准库中内置了时区数据库,作为在容器的系统环境中没有外置数据库时的 fallback 选择。