docs: 统一公开 API 的中英双语注释

- 补齐公开接口说明段的英文描述，保持签名注释和详细说明均为中英双语结构 - 规范农历、坐标、公式、轨道、日晷、太阳、恒星及行星事件等 API 的注释口径
2026-05-27 16:08:11 +08:00
parent 46b555cd49
commit c8dd777a7b
24 changed files with 310 additions and 6 deletions
@@ -100,6 +100,8 @@ func DownTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, e

 // DownTimeN 截断项日落时刻别名 / deprecated truncated sunset alias.
 //
+// Deprecated: use SetTimeN instead.
+//
 // 参数与 SetTimeN 相同，仅为兼容旧接口保留。
 // Same as SetTimeN and kept only for backward compatibility.
 func DownTimeN(date time.Time, lon, lat, height float64, aero bool, n int) (time.Time, error) {