月カレンダー

月の満ち欠け情報、ボイドオブコース期間、サイントランジット、次の月のアスペクトを計算します。

日別詳細

特定の日の月に関する詳細情報を取得する：

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/day" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

日付範囲

日付範囲の月カレンダー概要を取得する（最大31日）：

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/range" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

パラメータ

日別エンドポイント

パラメータ	型	必須	説明
dateTime	string	はい	YYYY-MM-DDTHH:mm 形式の日時
location	object	はい	緯度、経度、タイムゾーンを含む位置
aspects	array	いいえ	VOC計算に使用するアスペクト

範囲エンドポイント

パラメータ	型	必須	説明
startDate	string	はい	YYYY-MM-DD 形式の開始日
endDate	string	はい	YYYY-MM-DD 形式の終了日（最大31日）
location	object	はい	緯度、経度、タイムゾーンを含む位置
aspects	array	いいえ	VOC計算に使用するアスペクト

利用可能なアスペクト

• conjunction - 0度
• sextile - 60度
• square - 90度
• trine - 120度
• opposition - 180度

日別レスポンス

{
  "data": {
    "date": "2024-06-15",
    "moon": {
      "sign": "leo",
      "signEntry": "2024-06-15T08:23:00Z",
      "signExit": "2024-06-17T14:45:00Z",
      "phase": {
        "name": "Waxing Gibbous",
        "illumination": 0.72,
        "age": 9.3
      }
    },
    "voidOfCourse": {
      "isVoid": true,
      "start": "2024-06-15T18:45:00Z",
      "end": "2024-06-17T14:45:00Z",
      "durationMinutes": 2640,
      "lastAspect": {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z"
      },
      "nextSign": "virgo"
    },
    "upcomingAspects": [
      {
        "planet": "venus",
        "aspect": "sextile",
        "exactTime": "2024-06-15T14:30:00Z",
        "applying": true
      },
      {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z",
        "applying": true
      }
    ]
  }
}

範囲レスポンス

{
  "data": {
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "phases": [
      {
        "type": "new_moon",
        "date": "2024-06-06T12:37:00Z",
        "sign": "gemini"
      },
      {
        "type": "first_quarter",
        "date": "2024-06-14T05:18:00Z",
        "sign": "virgo"
      },
      {
        "type": "full_moon",
        "date": "2024-06-22T01:08:00Z",
        "sign": "capricorn"
      },
      {
        "type": "last_quarter",
        "date": "2024-06-28T21:53:00Z",
        "sign": "aries"
      }
    ],
    "signTransits": [
      {
        "sign": "gemini",
        "entry": "2024-06-01T03:15:00Z",
        "exit": "2024-06-03T08:45:00Z"
      },
      {
        "sign": "cancer",
        "entry": "2024-06-03T08:45:00Z",
        "exit": "2024-06-05T15:20:00Z"
      }
    ],
    "voidPeriods": [
      {
        "start": "2024-06-02T15:30:00Z",
        "end": "2024-06-03T08:45:00Z",
        "durationMinutes": 1035,
        "lastAspect": {
          "planet": "saturn",
          "aspect": "square"
        },
        "fromSign": "gemini",
        "toSign": "cancer"
      }
    ]
  }
}

ボイドオブコースムーン

ボイドオブコース（VOC）ムーンは、月が新しいサインに入る前に惑星との主要なアスペクトを形成しなくなる期間です。この期間は伝統的に新しい事業を始めることに不利とされています。

VOCの計算方法

1. 月の現在の位置とサインが決定される
2. 月が次のサインに入る正確な時刻が計算される
3. サイン変更までの月と主要惑星のすべてのアスペクトが検出される
4. 最後のアスペクトがVOC期間の開始を示す
5. 月が新しいサインに入るとVOC期間が終了する

VOCデータフィールド

フィールド	説明
isVoid	月が現在ボイドオブコースかどうか
start	VOC期間の開始時刻（最後のアスペクト時刻）
end	VOCが終了する時刻（月が新しいサインに入る）
durationMinutes	VOC期間の長さ（分）
lastAspect	最後のアスペクトの詳細
nextSign	月が次に入るサイン

ユースケース

• 選択占星術：VOCムーン中は重要な活動の開始を避ける
• 月相計画：月相に基づいて活動の最適なタイミングを追跡する
• 占星術カレンダー：月のサイントランジットと月相を表示する
• 儀式のタイミング：月の周期に合わせた活動を計画する