模组:SunXiu/doc
这是Module:SunXiu的文档页面
 | 此页面是Module:SunXiu的模块文档。 此页面可能包含了模板的使用说明、分类和其他内容。 |
本模块用于计算任意时刻太阳的精确位置，并将其映射到中国传统天文体系（二十八宿、十二次）与中西黄道体系（西洋十二宫、IAU真实星座）。
概述
[编辑]时区默认 UTC+8：
- 太阳几何位置：黄经、赤纬、赤经、日地距、均时差、视半径等。
- 二十四节气：以定气法迭代求解交节时刻，输出当前所处节气区间、已过天数、距下一节气天数。
- 黄道宫多体系对照：西洋回归十二宫 / 西洋恒星十二宫 / IAU 真实星座（含蛇夫座）/ 中国十二次+十二辰 / 二十八宿日躔。
完整参数表
[编辑]太阳几何位置
[编辑]| 字段 | 含义 | 单位 |
|---|---|---|
jd |
儒略日（UT） | 日 |
jd_tt |
儒略日（力学时 TT） | 日 |
T |
儒略世纪数（自 J2000.0 起） | 世纪 |
lon |
太阳真黄经（几何，未含光行差与章动） | ° |
lon_app |
视黄经（含光行差 + 章动修正） | ° |
lat |
黄纬（恒为 0，保留字段） | ° |
ra |
赤经 | 小时 |
ra_deg |
赤经 | ° |
dec |
赤纬 | ° |
dist_au |
日地距离 | AU |
eq_time |
均时差 | 分 |
eps_true |
真黄赤交角 | ° |
radius_arcsec |
太阳视半径 | ″ |
二十四节气（定气法）
[编辑]以春分黄经 0° 起，每 15° 一节气，二分法迭代求解交节时刻。
| 字段 | 含义 |
|---|---|
prev_term |
上一节气名 |
prev_term_jd |
上一节气交节 JD |
prev_term_time |
上一节气北京时间 |
cur_term |
当前所处节气段名（如"寒露后"） |
days_after_term |
当前节气后天数（浮点） |
days_after_term_hm |
格式化："第3天 04时12分" |
next_term |
下一节气名 |
next_term_jd |
下一节气 JD |
next_term_time |
下一节气北京时间 |
days_to_next_term |
距下一节气剩余天数（浮点） |
term_lon |
当前段对应黄经基准（如寒露 = 195°） |
黄道宫体系
[编辑]西洋回归黄道十二宫（Tropical，锚定春分点）
[编辑]| 字段 | 含义 |
|---|---|
trop_sign |
宫名（白羊宫/金牛宫/…/双鱼宫） |
trop_sign_cn |
中文宫名（同上，保留字段） |
trop_in_deg |
入本宫距度（0–30°） |
trop_days_to_next |
距下一宫天数 |
西洋恒星黄道（Sidereal，含岁差偏移）
[编辑]| 字段 | 含义 |
|---|---|
sidereal_sign |
恒星制宫名 |
sidereal_ayanamsa |
岁差修正量（°） |
sidereal_in_deg |
入宫距度（0–30°） |
IAU 实际黄道星座（含蛇夫座）
[编辑]| 字段 | 含义 |
|---|---|
iau_constellation |
真实星座（白羊座/…/蛇夫座/…） |
iau_in_deg |
入星座边界距度 |
iau_note |
"宫≠星座"说明 |
中国十二次（自西向东等分，配十二辰）
[编辑]| 字段 | 含义 |
|---|---|
xing_ci |
星次名（星纪/玄枵/娵訾/降娄/大梁/实沈/鹑首/鹑火/鹑尾/寿星/大火/析木） |
chen |
十二辰（子丑寅卯辰巳午未申酉戌亥） |
xingci_in_deg |
入本次距度 |
十二次↔十二辰↔宿大致对应：
- 星纪(丑)·斗牛｜玄枵(子)·女虚危｜娵訾(亥)·室壁｜降娄(戌)·奎娄｜大梁(酉)·胃昴毕｜实沈(申)·觜参｜鹑首(未)·井鬼｜鹑火(午)·柳星张｜鹑尾(巳)·翼轸｜寿星(辰)·角亢｜大火(卯)·氐房心｜析木(寅)·尾箕
中国二十八宿日躔
[编辑]| 字段 | 含义 |
|---|---|
sun_xiu |
太阳所在宿名 |
sun_xiu_in_deg |
入宿距度 |
sun_xiu_quji |
去极度（90° − 赤纬） |
sun_xiu_system |
所用宿度体系（huainan/dayan_ecl/dayan_equ/modern） |
sun_xiu_sysname |
宿度体系中文名 |
接口（公开函数）
[编辑]| 接口 | 说明 | 示例 |
|---|---|---|
p.get |
取任意单个字段值 | {{#invoke:SunXiu|get|param=sun_xiu}}
|
p.getJD |
取当前儒略日 | {{#invoke:SunXiu|getJD}}
|
p.infoBox |
完整信息框（6 区块） | {{#invoke:SunXiu|infoBox|system=modern}}
|
p.short |
简洁摘要（一行） | {{#invoke:SunXiu|short}}
|
p.solarTermTable |
指定年份 24 节气时刻表 | {{#invoke:SunXiu|solarTermTable|year=2026}}
|
p.zodiac |
多体系黄道宫对照表 | {{#invoke:SunXiu|zodiac}}
|
调用参数
[编辑]所有接口均接受以下 frame.args 参数：
| 参数 | 含义 | 默认 |
|---|---|---|
year |
年份 | 当前年 |
month |
月份（1–12） | 当前月 |
day |
日期（1–31） | 当日 |
hour |
小时（UTC+8） | 12 |
system |
二十八宿宿度体系，可选值：huainan（淮南子距度）dayan_ecl（大衍历黄道）dayan_equ（大衍历赤道）modern（现代真黄道） |
huainan
|
示例
[编辑]- 太阳所在宿名：
{{#invoke:SunXiu|get|param=sun_xiu}}→ 毕 - 太阳视黄经：
{{#invoke:SunXiu|get|param=lon_app}}→ 231.88614 - 太阳赤纬：
{{#invoke:SunXiu|get|param=dec}}→ -18.23537 - 儒略日：
{{#invoke:SunXiu|getJD}}→ 2461358.75 - 距下一节气天数（格式化）：
{{#invoke:SunXiu|get|param=days_after_term_hm}}→ 6天 20时02分 - 多体系对照：返回西洋宫 / 真实星座 / 十二次 / 宿的对照表。
{{#invoke:SunXiu|zodiac}} →
| 体系 | 名称 | 入度 | 备注 |
|---|---|---|---|
| 回归黄道宫 | 天蝎宫 | 21.89° | 春分点为0° |
| 恒星黄道宫 | 天秤座 | 28.89° | 岁差偏移 23.00° |
| IAU真实星座 | 天蝎座 | 21.89° | 注：IAU星座边界非均匀，此为近似 |
| 中国十二次 | 大火（辰在卯） | 21.89° | 起于星纪 |
| 二十八宿日躔 | 毕 | 5.89° | 体系：《淮南子·天文训》距度 |
- 指定参数：
{{#invoke:SunXiu|infoBox|year=2026|month=10|day=23|hour=20|system=modern}}→
模板
[编辑]基于 Module:SunXiu 计算当前或指定日期的太阳位置、二十八宿、节气、黄道宫等信息。
参数
[编辑]year– 年份（数字），默认当前年month– 月份（1–12），默认当前月day– 日期（1–31），默认当日hour– 小时（0–23，UTC+8），默认12时system– 二十八宿体系，可选huainan（默认）、dayan_ecl、dayan_equ、modern
输出内容
[编辑]- 浮动信息框：太阳所在的二十八宿、入宿距度、去极度、体系
- 几何位置：黄经、赤纬、赤经、日地距、均时差、视半径
- 节气状态：当前节气区间、已过时长、下一节气及时刻
- 回归黄道宫、恒星黄道宫、IAU真实星座、中国十二次
- 可折叠原始数据：JD、JD_TT、T、视黄经、赤纬、日地距、均时差、视半径
相关模板
[编辑]完整信息框
{{SunXiuall}}
{{SunXiuall|year=2026|month=10|day=23|hour=12|system=huainan}}
当前节气
{{SunJQ}}
太阳位置
{{SunXiuJJ}}
{{SunXiuJJ|year=2026|month=10|day=23|hour=12|system=modern}}
技术说明
[编辑]- 时区默认 UTC+8，若需其他时区请在调用前换算。
- "宫"≠"星座"：西洋十二宫为等分 30°，IAU 真实星座边界不均等（且含蛇夫座），两者不可混用。
- 十二次为等分体系，二十八宿不等分；跨宿/跨次边界以太阳真黄经精确判定。
- 节气时刻采用定气法，与现行农历节气一致；与平气法（固定 15.x 天）略有出入。
- 本模块为自包含设计，不依赖外部数据模块。
- 算法基于 Meeus 低阶 VSOP 简化公式，节气采用定气法（黄经每 15° 一节点）二分迭代求解。