3 个版本

0.1.0	2023 年 7 月 23 日

#208 在日期和时间

Apache-2.0

1MB
35K SLoC

Rust ephemeris

Rust ephemeris 是一个用 Rust 编写的天文历法库，支持广泛的年份范围，并提供多语言绑定。适用于广大天文历法爱好者和术数爱好者。

特性

支持计算二十四节气的具体时间点
支持计算农历朔望日计算
支持公历/农历之间的转换
支持八大行星+冥王星+太阳+月亮位置计算，方便占星以及七政四余爱好者排盘
支持上升点、中天以及东升点等星宫计算
支持八字四柱计算
支持儒略日计算
支持儒略日计算
支持多语言绑定，目前提供了 Python 绑定，计算支持 wasm 绑定以及 C 绑定

安装

克隆仓库

git clone https://github.com/tyxk8160/ephemeris.git

使用

Rust 用户

在 Cargo.toml 中添加依赖

[dependencies]
ephemeris = { git = "https://github.com/tyxk8160/ephemeris.git", branch = "master" } # 从git拉取

公历转农历

SolorDate(2023, 11,12) 表示公历 2023-11-12

use rust_ephemeris::lunnar::*; const YM:[&str;12]=["正月", "二月", "三月", "四月", "五月", "六月", "七月", "八月","九月", "十月", "冬月", "腊月"]; let x = SolorDate(2033, 12, 23).to_lunar_date(); println!("公历2023-12-23 农历：{}年 {}{} {}日", x.0, if x.3!=0{ "闰"} else {""}, YM[(x.1 as usize + 11)%12], x.2 );




- 公历转四柱
**注意**: 默认是采用东八区计算的，自己可以转真太阳时

```rust
use rust_ephemeris::lunnar::*;
let d = SolorDate(2023, 11, 11);
// 时间12点
let sz = d.sizhu(0.5);
println!("{} {} {} {}", sz.0, sz.1, sz.2, sz.3); // 癸卯 癸亥 癸酉 戊午

农历转公历

use rust_ephemeris::lunnar::*; let a = LunarDate(2023,10,17,0); println!("{:?}", a.to_solor_date()); // SolorDate(2023, 11, 29)


- 行星位置计算

计算2023-7-23 12:00水星星历 时区 东八区， 经度：116°23’ 纬39°54’

```rust
use rust_ephemeris::astronomy::*;
use rust_ephemeris::JulianDate;
use std::f64::consts::PI;
let body = CelestialBody::Mercury;
let  jd = JulianDate::from_day(2023, 7,23.5).jd;
let tz = -8.0; // 东八区
let lon = 116.0/180.0*PI + 23.0/60.0/180.0*PI;
// let lon = 1.9911297824990999;
let lat = 39.0/180.0*PI + 54.0/60.0/180.0*PI;
// let lat = 0.38746309394274114;
let pos = calculate_celestial_body(
   body,
   jd,
   tz,
   lon,
   lat
);

println!("{}", pos);

星座计算

计算 2023-3-21 18:30 东八区 121.45E， 31.216666666666665N
```
use std::f64::consts::PI;
```

use rust_ephemeris::astronomy::*; use rust_ephemeris::{JulianDate, math_utils};

let jd = JulianDate::from_day(2023, 3,21.0+10.5/24.0).jd;

let lon = -121.45/180.0*PI; let lat = 31.216666666666665/180.0 *PI; let mut h = Hourse::new(jd, -8.0, lon, lat);

println!("T={}", h.t()); println!("RA={}", math_utils::Angle::from_f64(h.ra()).degress(2));

//上升点的计算 println!("ASC={}", math_utils::Angle::from_f64(h.asc()).degress(2)); // 东升点计算 println!("EP={}", math_utils::Angle::from_f64(h.ep()).degress(2));

// 中天点计算 println!("MC={}", math_utils::Angle::from_f64(h.mc()).degress(2));


更多使用方法参考文档

**python用户**

暂时项目没稳定，未添加到pypi中

- 编译

```bash
cd <repo>/bindings/python
python setup.py build

基础使用

import ephemeris.ephemeris as eph
# 计算儒略日
print(eph.JulianDate(2023,7,23))

更多用户参考 Rust 文档

文档

生成文档

cargo doc --no-deps --open

常见问题解答

Q: 为什么会对天文历感兴趣
A：读《六壬大全》六十四课有一个天地二烦课，有一个月宿的起法口诀在不同的术数中存在部分的差异。而且根据字面意思，月宿是指的月亮的位置，且月宿周期为二十八天左右，与月亮公转周期接近。所以我考虑不用口诀起月宿，直接计算月亮位置，判断所属二十八星宿
Q: 为什么会重复造轮子写一个天文历的库？
A：大部分常见的历法库是 1900 年后，在看古书去校准时间多有不便。
Q: 为什么采用 Rust 编写？
A：天文历法是一个基础库，以后打算写一个排盘软件或者计算格局的东西。排盘适合自带丰富界面功能的 js 写，计算格局不需要界面自用采用 python 等脚本语言比较方便。Rust 有很好的三方库，很容易绑定到 python 、wasm、c，是开发基础库很好的选择。

贡献

我们非常欢迎社区的贡献。如果您发现任何错误或想改进 Rust ephemeris，请提交一个 pull 请求或创建一个 issue。

致谢

Jean Meeus - 因他的著作《天文算法》而为此项目提供了灵感。

Rust 社区 - 感谢他们在 Rust Astro 开发过程中提供的支持和帮助。

寿星天文历 - 大量的日历计算库支持的范围是 1900 年以后，寿星天文历是少量支持时间范围广，且精度有一定保证的适合东方人的历法

openai - 绝大部分代码是 chatGTP 从 js 代码或者一些数学公式翻译成 Rust，节省了大量的搬砖时间

rust-ephemeris

3 个版本

Rust ephemeris

特性

安装

使用

文档

常见问题解答

贡献

致谢

依赖项