Cron @weekly Special String: @weekly

Understanding @weekly

The cron expression @weekly breaks down as follows:

Field	Value	Meaning
Special	`@weekly`	Shorthand expression

When Does @weekly Run?

This cron expression will execute:

Once per week
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

@weekly /path/to/your/script.sh

Kubernetes CronJob

apiVersion: batch/v1
kind: CronJob
metadata:
  name: my-cronjob
spec:
  schedule: "@weekly"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: my-job
            image: my-image
          restartPolicy: OnFailure

GitHub Actions

on:
  schedule:
    - cron: '@weekly'

Node.js (node-cron)

const cron = require('node-cron');

cron.schedule('@weekly', () => {
  console.log('Running scheduled task');
});

Frequently Asked Questions

What does the cron expression @weekly mean?

Run once per week with @weekly. Equivalent to 0 0 * * 0.

How do I test @weekly cron expression?

Use our free Cron Expression Tester to validate @weekly. Enter the expression, see the next execution times, and verify it matches your expected schedule.

What timezone does @weekly 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 @weekly in Kubernetes?

Yes, Kubernetes CronJobs support standard 5-field cron expressions like @weekly. Add it to your CronJob spec.schedule field.

How many times does @weekly run per day?

Once per week

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