Understanding @annually
The cron expression @annually breaks down as follows:
| Field | Value | Meaning |
|---|---|---|
| Special | @annually | Shorthand expression |
When Does @annually Run?
This cron expression will execute:
- Once per year
- In the server's configured timezone (usually UTC)
Example Next Run Times
Starting from January 1, 2025 00:00:
- Depends on system events or calendar
How to Use This Cron Expression
Linux/Unix Crontab
@annually /path/to/your/script.sh
Kubernetes CronJob
apiVersion: batch/v1
kind: CronJob
metadata:
name: my-cronjob
spec:
schedule: "@annually"
jobTemplate:
spec:
template:
spec:
containers:
- name: my-job
image: my-image
restartPolicy: OnFailure
GitHub Actions
on:
schedule:
- cron: '@annually'
Node.js (node-cron)
const cron = require('node-cron');
cron.schedule('@annually', () => {
console.log('Running scheduled task');
});
Frequently Asked Questions
What does the cron expression @annually mean?
Run once per year with @annually. Equivalent to 0 0 1 1 *.
How do I test @annually cron expression?
Use our free Cron Expression Tester to validate @annually. Enter the expression, see the next execution times, and verify it matches your expected schedule.
What timezone does @annually run in?
Cron expressions use the system timezone by default. For servers, this is typically UTC. Always verify your server's timezone with 'timedatectl' or check your cron daemon configuration.
Can I use @annually in Kubernetes?
Yes, Kubernetes CronJobs support standard 5-field cron expressions like @annually. Add it to your CronJob spec.schedule field.
How many times does @annually run per day?
Once per year
Related Cron Expressions
More Cron Tools
GetDevUtils offers a suite of developer tools including:
- Cron Expression Tester - Validate and test cron expressions
- Unix Timestamp Converter - Convert timestamps
- JSON Formatter - Format and validate JSON
- Regex Tester - Test regular expressions