ForHosting KIT · 開発者向けツール

表形式イスラム暦のアーシューラーを西暦に変換

この計算ツールは、指定された表形式ヒジュラ暦年の10ムハッラム、すなわちアーシューラーの日を先発グレゴリオ暦の日付へ変換します。固定された算術イスラム暦を用いるため、同じ入力からはどの環境でも同じ結果が得られます。出力にはグレゴリオ暦の日付、曜日、使用した暦の名称、UTC基準が含まれます。表形式モデルを明示的に採用するソフトウェア、再現可能な研究、教育、データセット向けです。地域の観測や公的発表による宗教上の日付を決定するものではありません。

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

無料で実行 API仕様を見る

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

計算対象となるアーシューラーの日付をご確認ください

アーシューラーはムハッラム月の10日ですが、このヒジュラ暦日を民用日付へ変換するには、イスラム暦の方式を選ぶ必要があります。このツールは、技術資料で算術イスラム暦または民用イスラム暦とも呼ばれる表形式イスラム暦を使用します。この方式では、月の日数と閏年が固定された反復規則で決まります。1446のような正の整数でヒジュラ暦年をご入力いただくと、その年の10ムハッラムを先発グレゴリオ暦へ対応付けます。保存後も前提が分かるよう、出力には両方の暦方式を記載します。また、端末のタイムゾーンを参照せず決定的に暦日を表すため、UTCも明記します。地域での三日月観測、公的発表、天文学的な可視性基準、国の公式暦では、10ムハッラムが別のグレゴリオ暦日になる場合があります。表形式の結果が必要な場合に限ってご利用いただき、宗教的判断や地域の公式発表として扱わないでください。

決定的な変換の仕組みをご説明します

まず、指定された表形式ヒジュラ暦年の10ムハッラムに対応する整数のユリウス通日を求めます。固定された民用イスラム暦の元期を起点に、入力年より前の完全年数を加え、30年閏年周期の項を適用します。ムハッラムは最初の月なので、この行事について先行月を加算する必要はありません。得られた通日を整数演算により、先発グレゴリオ暦の年、月、日へ変換します。曜日も同じ通日から算出するため、返される各項目は整合します。JavaScriptのDateオブジェクトを作成しないので、システムのタイムゾーン、夏時間、言語設定、日付ライブラリの差は結果に影響しません。現在時刻もネットワークも参照しません。入力には1から1,000,000までの数値型整数が必要です。文字列、小数、範囲外の値は暗黙変換せずにエラーとして返します。

アプリやデータで結果を安全にお使いください

この機能は、過去の観測を復元したり将来の公式発表を予測したりすることより、再現性を優先する用途に適しています。同じ表形式規則を実装する暦ソフトウェアの固定テスト値を作る、算術イスラム暦と明記された資料を正規化する、教材用の年表を作る、複数の独立実装を比較するといった使い方ができます。ヒジュラ暦年、グレゴリオ暦日、暦の名称は一緒に保存してください。グレゴリオ暦日だけでは、変換の前提が分からなくなります。資料がウンム・アルクラー暦、政府機関の暦、天文学的な三日月可視性、地域観測を採用している場合は、それに対応するサービスをご利用ください。月初付近の1日の差は、プログラムの誤りではなく方式の違いかもしれません。APIリクエスト1件の料金は$0.002です。純粋関数で年ごとの答えが固定されるため、結果を年単位でキャッシュできます。UTCは計算基準を示すもので、すべての共同体が同時刻に行事を始めるという意味ではありません。

活用例

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

同じ表形式イスラム暦規則を実装するソフトウェア向けに、安定したグレゴリオ暦の期待値を生成します。

表形式ヒジュラ暦データを正規化

観測ではなく算術ヒジュラ暦を使用すると明記された記録に、グレゴリオ暦日を追加します。

教育用の年表を作成

暦方式の前提を明示しながら、10ムハッラムがグレゴリオ暦上を移動する様子を示します。

よくある質問

公的に観測されるアーシューラーの日を予測しますか？

いいえ。固定された表形式イスラム暦の10ムハッラムを計算します。公式暦や観測暦では1日以上異なる場合があります。

なぜ先発グレゴリオ暦と表示されるのですか？

各地域が歴史的にグレゴリオ暦を採用する前の年を含め、すべての年に同じ規則を適用するためです。

タイムゾーンによって結果は変わりますか？

いいえ。Date、システム時計、夏時間情報、端末のタイムゾーンを使わず、整数の暦計算だけを行います。

どのような入力を受け付けますか？

1から1,000,000までのヒジュラ暦年を数値型整数でご入力ください。文字列、小数、範囲外の値は受け付けません。

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

APIリクエスト1件の料金は$0.002です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/ashura-tabular

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

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

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

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

import os, requests

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

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

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

リクエスト例

{
  "year": 1446
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.ashura_tabular",
  "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の完全なドキュメントを見る →