Scheduling Options ¶

Steam Stats uses GitHub Actions’ schedule event with cron syntax to run automatically at defined times.

How Scheduled Events Work¶

In your workflow YAML, the schedule block defines one or more cron expressions. GitHub Actions triggers the workflow when the expression matches the set time.

on:
    schedule:
        - cron: "<cron-expression>"

Cron expressions consist of five space-separated fields:

Field	Allowed Values	Description
Minute	0–59	Minute of the hour
Hour	0–23	Hour of the day (UTC)
Day of month	1–31	Day of the month
Month	1–12 or JAN–DEC	Month of the year
Day of week	0–6 or SUN–SAT	Day of the week (0=Sunday)

Info

All times are in UTC, regardless of your repository or local timezone.

Common Cron Examples¶

Schedule	Cron Expression	Description
Every minute	`* * * * *`	Triggers every minute
Hourly	`0 * * * *`	At minute 0 of every hour
Daily at midnight UTC	`0 0 * * *`	Every day at 00:00 UTC
Weekly on Monday 00:00	`0 0 * * 1`	Mondays at 00:00 UTC
Weekly on Monday 05:30 IST	`30 18 * * 0`	Mondays at 00:00 IST (UTC+5:30)
Monthly on 1^st at 00:00	`0 0 1 * *`	First day of month at 00:00 UTC

For more, see Crontab Guru Examples.

Default Steam Stats Schedule¶

The default schedule in the Quick Start is:

on:
    schedule:
        # Runs every Monday at 00:00 IST (18:30 UTC on Sunday)
        - cron: "30 18 * * 0"

Customizing Your Schedule¶

Edit the cron expression in .github/workflows/steam-stats.yml.
Commit and push; GitHub Actions will pick up the change.

Sample Schedules¶

Daily at 12:00 UTC

on:
    schedule:
        - cron: "0 12 * * *"

Every 6 hours

on:
    schedule:
        - cron: "0 */6 * * *"

Weekdays at 08:00 UTC

on:
    schedule:
        - cron: "0 8 * * 1-5"

Advanced Tips¶

Multiple schedules: You can list multiple cron entries.
Comments: Precede cron entries with comments for clarity.
Validation: Use Crontab Guru to test your expressions.
GitHub Docs: Detailed reference at GitHub Scheduled Events.

Return to the User Guide or continue to Configuration.