ForHosting KIT · 開発者向けツール

年ごとの過越祭開始日計算ツール

過越祭開始日計算ツールは、指定した年に祭日が日没から始まるグレゴリオ暦上の日付を求めます。19年周期、モラドの計算、ローシュ・ハシャナの延期規則、月の日数の変化を含む固定ユダヤ暦の算術規則を適用します。結果には、ニサン15日に当たる翌日の民間暦日と該当するユダヤ暦年も含まれます。外部の暦サービス、現在時刻、タイムゾーン検索、ネットワークを利用せず、すべてローカルかつ決定的に計算します。

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

無料で実行 API仕様を見る

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

返される開始日が示すもの

ユダヤ暦の一日は午前0時ではなく日没に始まるため、過越祭の日付には密接に関連する二つの表し方があります。このツールでは、祭日が日没から始まる民間暦の日を主な過越祭開始日として返します。同時に、ニサン15日の日中に当たる翌日のグレゴリオ暦日を <code>first_day_date</code> として示します。たとえばニサン15日が火曜日なら、祭日は月曜日の夕方に始まるため、主な結果は月曜日です。二つの日付を明記することで、予定表、旅行計画、学校暦、ソフトウェア連携で生じやすい一日のずれを防げます。応答にはユダヤ暦年、ユダヤ暦日付の表記、日没開始を示す真偽値も含まれます。入力する年は、その春に過越祭が行われるグレゴリオ暦年です。そのため、夕方の開始日と最初の日中の日付のどちらを表示する場合でも、意図せず日をずらすことなく扱えます。

ユダヤ暦の算術規則で日付を決める仕組み

計算では最初に、指定したグレゴリオ暦の春を対応するユダヤ暦年に関連付けます。次に、19年のメトン周期で経過した月数からティシュリ月の平均朔であるモラドを求めます。延期規則を適用してティシュリ1日を決定します。遅い時刻のモラドによる延期、平年と閏年直後の年を保護する二つの条件、さらにローシュ・ハシャナを日曜日、水曜日、金曜日に置かない規則が含まれます。連続する二つのユダヤ暦新年の間隔により、ヘシュヴァン月とキスレーヴ月が短い形か長い形かを判定します。その後、ティシュリ、ヘシュヴァン、キスレーヴ、テベット、シェバット、および該当する一つまたは二つのアダル月の日数を加算してニサン15日に到達します。最後に、整数の固定日数を先発グレゴリオ暦の年月日に変換し、一日を引いて夕方に始まる民間暦日を得ます。月の実観測や年別一覧、地域設定に依存する日付処理ではなく、確立された算術暦の規則です。

決定性、対応年、実務での利用

1から9999までの整数のグレゴリオ暦年を指定できます。システム時計を読まず、<code>Date</code> オブジェクトを作成せず、利用者のタイムゾーンを推測せず、乱数も外部サービスも使いません。したがって、同じ入力からはブラウザー、API 処理、ビルドパイプライン、テスト環境のいずれでも同じ JSON 結果が得られます。将来の祝祭日カレンダーの作成、取り込んだ予定の検証、定期的な案内の準備、再現可能なデータセットの構築に役立ちます。正確な日没時刻は場所や大気条件によって変わるため、この機能は日没の時刻情報ではなく民間暦の日付を返します。ろうそくの点火時刻や祭日の正確な現地開始時刻が必要な場合は、返された日付と位置情報に基づく日没計算を組み合わせてください。歴史的な用途では、固定算術ユダヤ暦を先発グレゴリオ暦へ投影します。過去の観測慣行、地域ごとの布告、当時の民間暦制度は再現しません。API リクエストの料金は $0.002 で、ブラウザーでも同じ純粋な算術処理を使用します。

活用例

年次祝祭日カレンダーの作成

年ごとの一覧表を保守せずに、日没の開始日と最初の日中の日付を生成できます。

取り込んだ予定データの検証

受け取った過越祭の日付を、ユダヤ暦の算術規則で独立に求めた結果と比較できます。

事前案内のスケジュール設定

通知や運用案内を用意する前に、祭日が始まる正しい民間暦上の夕方を確認できます。

よくある質問

返される日付は日没時ですか、それとも翌日ですか？

主な <code>date</code> は過越祭が日没から始まるグレゴリオ暦日です。<code>first_day_date</code> はニサン15日に当たる翌日の民間暦日です。

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

API リクエストの料金は $0.002 です。範囲の定まった算術計算を行い、1件のリクエストを1項目として数えます。

オンラインのユダヤ暦サービスを参照しますか？

参照しません。決定的な整数演算だけを用い、ネットワークリクエストは行いません。

現地の日没時刻まで正確に計算しますか？

計算しません。正確な時刻には位置情報と天文計算が必要です。この機能は日没から始まるグレゴリオ暦の日付を返します。

過越祭がニサン15日の前日に始まるのはなぜですか？

ユダヤ暦の一日は日没に始まるためです。ニサン15日を開く夕方は、グレゴリオ暦では前日の民間暦日に属します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/passover-start

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

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

curl -X POST https://api.kit.forhosting.com/date/passover-start \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

const res = await fetch("https://api.kit.forhosting.com/date/passover-start", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 2026
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/passover-start",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2026
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/passover-start", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":2026}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":2026}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/passover-start", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "year": 2026
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

エラー

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

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