feat(moon): 新增行星合月查询并修正月球地心赤经赤纬接口

- 修正月球地心真/视赤经赤纬接口口径 - 新增月球与七大行星合月时刻查询
2026-05-23 19:00:53 +08:00
parent 34ff6a36ae
commit be3af3884c
13 changed files with 1302 additions and 3 deletions
@@ -0,0 +1,72 @@
+package moon
+
+import (
+	"time"
+
+	"b612.me/astro/basic"
+)
+
+// ConjunctionPlanet 月球合月目标行星 / target planet for Moon-planet conjunction.
+type ConjunctionPlanet string
+
+const (
+	ConjunctionMercury ConjunctionPlanet = "mercury"
+	ConjunctionVenus   ConjunctionPlanet = "venus"
+	ConjunctionMars    ConjunctionPlanet = "mars"
+	ConjunctionJupiter ConjunctionPlanet = "jupiter"
+	ConjunctionSaturn  ConjunctionPlanet = "saturn"
+	ConjunctionUranus  ConjunctionPlanet = "uranus"
+	ConjunctionNeptune ConjunctionPlanet = "neptune"
+)
+
+func conjunctionPlanetToBasic(planet ConjunctionPlanet) basic.MoonPlanetConjunctionPlanet {
+	switch planet {
+	case ConjunctionMercury:
+		return basic.MoonPlanetConjunctionMercury
+	case ConjunctionVenus:
+		return basic.MoonPlanetConjunctionVenus
+	case ConjunctionMars:
+		return basic.MoonPlanetConjunctionMars
+	case ConjunctionJupiter:
+		return basic.MoonPlanetConjunctionJupiter
+	case ConjunctionSaturn:
+		return basic.MoonPlanetConjunctionSaturn
+	case ConjunctionUranus:
+		return basic.MoonPlanetConjunctionUranus
+	case ConjunctionNeptune:
+		return basic.MoonPlanetConjunctionNeptune
+	default:
+		return 0
+	}
+}
+
+func validConjunctionPlanet(planet ConjunctionPlanet) bool {
+	return conjunctionPlanetToBasic(planet) != 0
+}
+
+// LastConjunctionWithPlanet 上一次行星合月（赤经合） / previous Moon-planet conjunction.
+func LastConjunctionWithPlanet(date time.Time, planet ConjunctionPlanet) time.Time {
+	if !validConjunctionPlanet(planet) {
+		return time.Time{}
+	}
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastMoonPlanetConjunction(jde, conjunctionPlanetToBasic(planet)), date.Location(), false)
+}
+
+// NextConjunctionWithPlanet 下一次行星合月（赤经合） / next Moon-planet conjunction.
+func NextConjunctionWithPlanet(date time.Time, planet ConjunctionPlanet) time.Time {
+	if !validConjunctionPlanet(planet) {
+		return time.Time{}
+	}
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextMoonPlanetConjunction(jde, conjunctionPlanetToBasic(planet)), date.Location(), false)
+}
+
+// ClosestConjunctionWithPlanet 最近一次行星合月（赤经合） / closest Moon-planet conjunction.
+func ClosestConjunctionWithPlanet(date time.Time, planet ConjunctionPlanet) time.Time {
+	if !validConjunctionPlanet(planet) {
+		return time.Time{}
+	}
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.ClosestMoonPlanetConjunction(jde, conjunctionPlanetToBasic(planet)), date.Location(), false)
+}