Skip to content

Commit 3f7f8d5

Browse files
authored
feat(github-workflow): add timezone property to on.schedule[] items (SchemaStore#5479)
See - GitHub blog https://github.blog/changelog/2026-03-19-github-actions-late-march-2026-updates/#github-actions-timezone-support-for-scheduled-workflows - `on.schedule` docs https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#onschedule - github/docs@1ead651 (Update schedule docs to include timezone (pr 60290), 2026-03-19) - actions/languageservices@a7f581b (Add timezone to workflow and pass FF (pr 334), 2026-03-06)
1 parent 1750f4a commit 3f7f8d5

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

src/schemas/json/github-workflow.json

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1779,16 +1779,22 @@
17791779
"description": "You can use the GitHub API to trigger a webhook event called repository_dispatch when you want to trigger a workflow for activity that happens outside of GitHub. For more information, see https://developer.github.com/v3/repos/#create-a-repository-dispatch-event.\nTo trigger the custom repository_dispatch webhook event, you must send a POST request to a GitHub API endpoint and provide an event_type name to describe the activity type. To trigger a workflow run, you must also configure your workflow to use the repository_dispatch event."
17801780
},
17811781
"schedule": {
1782-
"$comment": "https://help.github.com/en/github/automating-your-workflow-with-github-actions/events-that-trigger-workflows#scheduled-events-schedule",
1783-
"description": "You can schedule a workflow to run at specific UTC times using POSIX cron syntax (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). Scheduled workflows run on the latest commit on the default or base branch. The shortest interval you can run scheduled workflows is once every 5 minutes.\nNote: GitHub Actions does not support the non-standard syntax @yearly, @monthly, @weekly, @daily, @hourly, and @reboot.\nYou can use crontab guru (https://crontab.guru/). to help generate your cron syntax and confirm what time it will run. To help you get started, there is also a list of crontab guru examples (https://crontab.guru/examples.html).",
1782+
"$comment": "https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule",
1783+
"description": "You can schedule a workflow to run at specific UTC times using POSIX cron syntax (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/crontab.html#tag_20_25_07). You can optionally specify a timezone using an IANA timezone string (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for timezone-aware scheduling. Scheduled workflows run on the latest commit on the default or base branch. The shortest interval you can run scheduled workflows is once every 5 minutes.\nNote: GitHub Actions does not support the non-standard syntax @yearly, @monthly, @weekly, @daily, @hourly, and @reboot.\nYou can use crontab guru (https://crontab.guru/) to help generate your cron syntax and confirm what time it will run. To help you get started, there is also a list of crontab guru examples (https://crontab.guru/examples.html).",
17841784
"type": "array",
17851785
"items": {
17861786
"type": "object",
17871787
"properties": {
17881788
"cron": {
1789+
"description": "A cron expression that represents a schedule. A scheduled workflow will run at most once every 5 minutes.",
1790+
"type": "string"
1791+
},
1792+
"timezone": {
1793+
"description": "A string that represents the time zone a scheduled workflow will run relative to in IANA format (e.g. 'America/New_York' or 'Europe/London'). If omitted, the workflow will run relative to midnight UTC.",
17891794
"type": "string"
17901795
}
17911796
},
1797+
"required": ["cron"],
17921798
"additionalProperties": false
17931799
},
17941800
"minItems": 1

0 commit comments

Comments
 (0)