ForHosting KIT · サイト取得・監視

cron式から次回の実行時刻を計算

5フィールドのUnix cron式を、将来の実行時刻を並べた具体的な一覧へ変換します。スケジュール、ISO 8601形式の開始日時、必要な件数をご指定ください。不正な式を推測で補正せず、リスト、範囲、ステップの一般的なcron規則に従って検証します。結果は正規化したUTC日時で返すため、ジョブを公開する前の確認、テスト、保存、比較にそのままご利用いただけます。計算結果は常に決定的です。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

固定した開始日時からcronスケジュールを確認できます

cron式は短く表現できる一方、デプロイ前の確認では読み違いが起こりやすい形式です。この計算ツールを使うと、式を目視で解釈する代わりに、実際の実行日時を順番に確認できます。フィールドは、分、時、日、月、曜日の順に5つ入力してください。続いて、末尾がZの形式、または数値のUTCオフセットを含むISO 8601形式で開始日時をご指定ください。返される日時はすべて開始時点より後であり、UTCに正規化されます。そのため、同じ入力ならブラウザー、テスト環境、サーバーのどこでも同じ結果になります。開始日時を明示すると、深夜、月末、うるう年、オフセットの切り替わり付近も正確に確認できます。件数は1件から50件まで指定可能です。レスポンスには整列済みの実行日時だけが含まれるため、プレビュー、テスト用fixture、自動リリース判定での直接比較に適しています。現在時刻は参照しないため、過去に行った検証も再現できます。

対応する5フィールドcronの規則をご確認ください

各フィールドでは、アスタリスク、単一の数値、コンマ区切りのリスト、両端を含む範囲、ステップをご利用いただけます。したがって、*/15、1-5、0,30、2-10/2のような式を追加設定なしで処理できます。分は0から59、時は0から23、日は1から31、月は1から12、曜日は0から7です。曜日の0と7はいずれも日曜日を表します。日と曜日の両方に制限がある場合は、一般的なUnix cronと同様に、どちらか一方が一致すれば対象日になります。一方がアスタリスクなら、もう一方のフィールドで日付が決まります。秒、年、MONのような英字名、L、W、?、#など製品固有の拡張記法には対応していません。未対応の記法に推測で意味を割り当てると、実際に使用するスケジューラーと動作が食い違うおそれがあります。そのため、本機能では不明な記法を明確な入力エラーとして安全に拒否します。

レビュー、テスト、運用に結果を活用できます

cron文字列を人とシステムの間で受け渡す場面では、実行時刻のプレビューが役立ちます。設定画面では、ジョブを保存する前に次回以降のUTC日時を表示できます。継続的インテグレーションでは、生成した一覧を承認済みのfixtureと比較し、小さな文字変更に紛れた実行頻度の変化を検出できます。障害調査では、対象期間の直前を開始日時に指定し、設定済みの式が観測された実行を発生させ得たかを確認できます。計算はローカルかつ決定的であり、ネットワークサービス、保存状態、乱数、端末のタイムゾーンを使用しません。フィールド数の誤り、範囲外の値、降順の範囲、0のステップ、存在しない日時、未対応の記号には、内容が分かる入力エラーを返します。APIの料金は1リクエストあたり$0.002で、ブラウザーでは同じ計算をローカルに実行できます。結果は標準UTC形式なので、地域ごとの表示形式に変換せず直接比較できます。

活用例

デプロイ前にスケジュールを確認

レビュー中に次回の実行日時を一覧化し、ジョブを有効にする前にフィールド、範囲、頻度の誤りを検出できます。

スケジュールのプレビューを作成

cronエディターの横に具体的なUTC日時を表示し、保存前に設定の動作をご確認いただけます。

再現可能なテストfixtureを作成

固定した開始日時から期待される実行を生成し、現在時刻を参照せず自動テストで比較できます。

よくある質問

どのcron形式に対応していますか？

分、時、日、月、曜日の順で記述する、一般的な5フィールドのUnix cron式に対応しています。

結果に開始日時は含まれますか？

含まれません。開始日時が予定された分と完全に一致する場合でも、返される日時は必ずその後になります。

どのタイムゾーンを使用しますか？

開始日時の数値オフセットを反映し、計算結果はすべて末尾がZのUTC形式で返します。cronの各フィールドもUTCとして評価します。

cron式が不正な場合はどうなりますか？

不正なフィールドまたは値を示す入力エラーになります。式を自動修正したり、意味を推測したりすることはありません。

APIリクエストの料金はいくらですか？

APIは1リクエストあたり$0.002です。同じ計算をブラウザー内でローカルに実行することもできます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/web/cron-next-runs

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/web/cron-next-runs \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cron_expression":"30 9 * * 1-5","start_timestamp":"2026-07-24T12:00:00Z"}'

const res = await fetch("https://api.kit.forhosting.com/web/cron-next-runs", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cron_expression": "30 9 * * 1-5",
    "start_timestamp": "2026-07-24T12:00:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/cron-next-runs",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "cron_expression": "30 9 * * 1-5",
    "start_timestamp": "2026-07-24T12:00:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/cron-next-runs", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"cron_expression":"30 9 * * 1-5","start_timestamp":"2026-07-24T12:00:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"cron_expression":"30 9 * * 1-5","start_timestamp":"2026-07-24T12:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/cron-next-runs", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "cron_expression": "30 9 * * 1-5",
  "start_timestamp": "2026-07-24T12:00:00Z"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.cron_next_runs",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_items 50

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →