月亮日历

计算月相信息、月亮空亡期、星座行运以及即将到来的月亮相位。

单日详情

获取特定日期的详细月亮信息：

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	否	用于计算空亡期的相位类型

日期范围端点

参数	类型	必填	描述
startDate	string	是	开始日期，格式为 YYYY-MM-DD
endDate	string	是	结束日期，格式为 YYYY-MM-DD（最多 31 天）
location	object	是	包含纬度、经度、时区的地点信息
aspects	array	否	用于计算空亡期的相位类型

可用相位

• 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）是月亮在进入新星座之前不再与任何行星形成主要相位的时期。传统上认为这段时期不利于开始新的事业。

空亡期的计算方式

1. 确定月亮当前位置和所在星座
2. 计算月亮进入下一个星座的精确时间
3. 找出月亮在星座转换之前与主要行星之间的所有相位
4. 最后一个相位标志着空亡期的开始
5. 月亮进入新星座时空亡期结束

空亡期数据字段

字段	描述
isVoid	月亮当前是否处于空亡期
start	空亡期开始时间（最后一个相位的时间）
end	空亡期结束时间（月亮进入新星座）
durationMinutes	空亡期时长（分钟）
lastAspect	最后一个相位的详情
nextSign	月亮将要进入的星座

使用场景

• 择日占星：避免在月亮空亡期开始重要活动
• 月相规划：根据月相追踪活动的最佳时机
• 占星日历：显示月亮星座行运和月相
• 仪式时机：规划与月亮周期同步的活动