・毎日決まった時刻に処理を自動で動かしたい
・cron式を日本時間でどう書くか迷っている
・WorkflowsやQueuesとの違いを知りたい
Cloudflare Cron Triggers は、cron 式で決めた時刻に Worker の scheduled() を呼び出し、Cloudflare Workers のプログラムを自動で動かす機能です。サーバーを用意せずに、外部 API からのデータ取得や保守のような定期の仕事を置けます。無料プランでも使えます。
この記事では、仕組み、cron 式の書き方、料金と上限、Workflows・Queues との使い分け、始め方、注意点を扱います。時刻は UTC で動くため、日本時間からの書き直し方を詳しく説明します。仕様は Cron Triggers の公式ドキュメント をもとにしています。
この記事のゴール(読了目安 約8分)
Cron Triggersの仕組みと上限を知り、cron式をUTCで正しく書いて定期処理を始められるようになる
Cron Triggersとは:定期実行の機能
Cron Triggers は、cron 式(「毎時0分」のように、動かす時刻を5つの欄で書く書き方)を Worker の scheduled() ハンドラーに対応付け、決まった予定で Worker を動かす仕組みです。予定1つ分を Cron Trigger と呼びます。
Cloudflare Workers は、Cloudflare のネットワークでアプリを動かすサーバーレスの基盤です。2020年9月に Cron Triggers が発表されるまで、Worker は HTTP リクエストが届いたときにしか動きませんでした。リクエストが届かなくても、決めた時刻に Worker が動きます。 Workers そのものの仕組みと料金は、Cloudflare Workers の記事で解説しています。
公式の説明や例に出てくる使い道は次の4つです。
- 外部 API を呼び、最新のデータを集める
- KV や Durable Objects に保存した値を更新する
- 保守の作業や通知の送信
- 予約公開やバックアップ(CMS「EmDash」の例)
集めた値の置き場所には Workers KV が使えます。KV の仕組みは Workers KVとは で解説しています。Vercel の Cron Jobs の移り先も、公式の移行ガイドでは Cron Triggers です。
仕組み:scheduled()が呼ばれる流れ
設定した時刻(UTC)になると、Cloudflare が Worker の scheduled() を呼び出します。scheduled() ハンドラー(予定の時刻に呼ばれる関数)は次のものを受け取ります。
1つの Worker に複数の予定を書くと、どれも同じ scheduled() を呼びます。どの予定で起きたかは controller.cron で見分けます。 値は設定に書いた文字列と空白まで同じです。
ランタイムは scheduled() の処理が終わるのを15分まで待ちます。処理が1つなら waitUntil() は要らず、複数を同時に走らせるときに使います。実行する場所は、Cloudflare の中で空いているマシンです。

cron式の書き方と日本時間の換算
cron 式は5つの欄で書き、時刻は UTC(協定世界時)です。日本時間は UTC より9時間進んでいるので、9時間引いて書きます。
曜日の数字は 1=日曜〜7=土曜で、0=日曜とする一部の cron とは違います。曜日は数字より SUN・MON のような略称で書くと紛れません。 公式の例から抜き出すと次のとおりです(時刻は UTC)。
L は月の最終日か最後の指定曜日、W は最も近い平日、# は何回目の曜日かを表します。29〜31日を指定すると、その日が無い月には動きません。
次の表は、日本時間の予定を UTC に直した編集部の計算例です(公式の例ではありません)。
9時間戻して日付をまたぐと、曜日や「1日」も前の日にずれます。 平日の朝なら曜日を日〜木に、月初なら日の欄を L にします。

料金と無料プランの上限
2020年の発表時のブログは、Cron Triggers 自体に追加料金はかからないと説明しています。2026年11月時点の公式ページの上限と料金は次のとおりです。
無料プランは Cron Triggers 5個、1回の CPU 時間10ミリ秒までです。 CPU 時間は計算している時間だけで、API や KV、データベースの応答待ちは数えません。経過時間(待ち時間を含めた始まりから終わりまで)は、どちらも15分が上限です。
料金ページには、有料プランで1時間に1回の Cron Trigger を動かし、レポートを作る Worker の試算例があります。実行1回を1リクエストとして月720リクエスト、1回の CPU 3分とした例で、月5ドルに CPU 時間の1.99ドルを足した月6.99ドルです。
Workflows・Queuesとの使い分け
時刻で Worker を短く動かすなら Cron Triggers で足ります。手順が多い、やり直したい、15分で終わらない定期処理は Workflows の schedules で組みます。
Workflows の schedules は2026年6月に加わり、cron 式を書くと時刻ごとに Workflow が起動します。公式はバックアップやレポートの集計を用途に挙げています。2026年11月時点の公式ページでは、schedules はアカウントあたり100個まで書けます。
手順ごとの再試行や待ち時間の仕組みは、Cloudflare Workflowsとは?手順を確実に進める仕組みと料金 で解説しています。キューにためて後から処理する流れは、Cloudflare Queuesとは で説明しています。

Cron Triggersの始め方
Cloudflare のアカウントと Node.js を用意し、Wrangler(Cloudflare の CLI)で次の5段を進めます。
npm create cloudflare@latest -- my-first-workerでプロジェクトを作る(Hello World example → Worker only)- コードに
scheduled()を書く - 設定ファイルの
triggersにcronsを書く - 手元で
scheduled()を呼んで試す npx wrangler deployで公開し、Cron Events で確かめる
最小の形は次のとおりで、"0 * * * *" は毎時0分です。
export default {
async scheduled(controller, env, ctx) {
console.log("cron processed");
},
};
{
"triggers": {
"crons": ["0 * * * *"]
}
}
手元では予定の時刻が来ても動かないので、URL を呼んで1回ずつ試します。 公式の例ページの手順は次のとおりです。
npx wrangler dev --test-scheduled
curl "http://localhost:8787/cdn-cgi/local/scheduled?cron=*+*+*+*+*"
Wrangler 4.139.0 以上なら、Local Explorer(手元の開発中にブラウザで開く画面)からも試せます。ダッシュボードの Settings → Triggers → Cron Triggers からも予定を足せます。
使う前の注意点
本番で困りやすいのは、設定の反映・管理の場所・止め方・失敗の見つけ方の4つです。
- 予定の追加・変更・削除が世界中の拠点に行き渡るまで、最大15分かかります。その間の実行は抜けることがあり、行き渡った後の次の時刻から動きます
- Wrangler でデプロイすると、それまでの予定は設定ファイルの
triggersの内容に置き換わります。Wrangler で管理するなら、予定は設定ファイルだけに書きます - 止めるときは
cronsを空の配列([])にしてデプロイします。cronsの行をコメントアウトしても、Cron Trigger は止まりません - 失敗に気づく場所を公開前に確かめます。新しい Worker は、実行の記録が出るまで最大30分かかります
よくある質問
1分より短い間隔で動かせますか?
cron 式の5つの欄は「分」から始まり、公式の例で最も細かいのは毎分(* * * * *)です。1分より短い間隔を指定できるかは、公式ページで確認してください。
Cloudflare Pagesでも使えますか?
Pages Functions は Cron Triggers に対応していません。公式の機能の比較表でも Pages は対象外なので、定期処理は Workers で作ります。
1つのWorkerにいくつまで設定できますか?
Worker ごとに3つまでの上限は2023年10月に撤廃されました。複数の予定は controller.cron で分けます。2026年11月時点の公式ページでは、上限はアカウント全体で Free 5個、Paid 250個です。
実行に失敗したかはどこで確かめますか?
Worker の Settings → Trigger Events → View events で開く Cron Events に、直近100回分が残ります。それより前は Workers Logs で探します。waitUntil() を使う場合は、最初に失敗したものが状態として記録されます。
Pythonでも書けますか?
書けます。2025年4月から Python の Worker でも使え、WorkerEntrypoint を継承したクラスに scheduled メソッドを書きます。
この記事のポイント
- cron式で決めた時刻にWorkerのscheduled()が呼ばれる仕組み
- 時刻はUTC。日本時間から9時間引き、曜日や月末のずれにも注意
- 無料プランは5個・CPU 10ミリ秒まで。1回の実行は最長15分
- 手順が多くやり直しが要る定期処理はWorkflowsのschedulesへ
まとめ
Cron Triggers は、cron 式で決めた時刻に Worker の scheduled() を呼ぶ機能です。時刻は UTC なので、日本時間から9時間引き、曜日や月末のずれも確かめて書きます。2026年11月時点の公式ページでは、無料プランでもアカウントで5個まで使え、1回の実行は15分までです。
まずは1時間ごとの短い処理で scheduled() を書き、手元で /cdn-cgi/local/scheduled を呼んで試してから公開します。公開後は Cron Events で記録を見てください。手順が多くやり直しが要る定期処理は、Workflows の記事で仕組みを確かめてから選びます。






