# time.sun 库模块帮助文档

## time.sun 成员列表 <a id="time.sun" href="#time.sun">&#x23;</a>

太阳位置与农历二十四节气。  
注意农历是阴阳合理，而二十四节气是基于太阳视运动的“太阳历”。  
相关库 time.lunar （农历月历）。  
 time.julianDay （儒略日）

### time.sun.getApparentLongitude <a id="time.sun.getApparentLongitude" href="#time.sun.getApparentLongitude">&#x23;</a>
计算指定时刻的太阳视黄经（弧度）

### time.sun.getApparentLongitude(儒略世纪数,精度) <a id="time.sun.getApparentLongitude" href="#time.sun.getApparentLongitude">&#x23;</a>
精度参数可选，默认为-1（全精度）

### time.sun.getSolarTerm(年份,节气名或黄经度数) <a id="time.sun.getSolarTerm" href="#time.sun.getSolarTerm">&#x23;</a>
获取指定年份某个特定节气的时刻  
参数2可以是节气名称（如"立春"）或黄经度数（如315）  
返回包含 name,longitude,jdUtc,jdBjt,dateBjt,date 字段的表对象，  
date 字段为 time 对象。

### time.sun.getSolarTerms <a id="time.sun.getSolarTerms" href="#time.sun.getSolarTerms">&#x23;</a>
获取指定公历年份的二十四节气。

### time.sun.getSolarTerms(年份) <a id="time.sun.getSolarTerms" href="#time.sun.getSolarTerms">&#x23;</a>
获取指定公历年份的二十四节气列表，  
返回包含 24 个节气信息的数组，  
每个元素包含 name,longitude,jdUtc,jdBjt,dateBjt 字段

### time.sun.getTimeOfLongitude(黄经弧度) <a id="time.sun.getTimeOfLongitude" href="#time.sun.getTimeOfLongitude">&#x23;</a>
计算太阳到达指定黄经的精确时刻  
返回 UT 儒略日数（相对于 J2000.0）
