运限对象

let h = chart.horoscope("2025-6-1", 0)?;

pub struct AgeItem {
    pub base: HoroscopeItem,
    pub nominal_age: u32,          // 该日期对应的虚岁
}

pub struct YearlyItem {
    pub base: HoroscopeItem,
    pub yearly_dec_star: YearlyDecStar,
}

pub struct YearlyDecStar {
    pub jiangqian12: Vec<StarKey>, // 流年将前十二神，按宫位索引排列
    pub suiqian12: Vec<StarKey>,   // 流年岁前十二神，按宫位索引排列
}

let h = chart.horoscope("2025-6-1", 0)?;

for item in [&h.decadal, &h.monthly, &h.daily, &h.hourly] {
    println!("{} 落在宫位 {} 干支 {}{}", item.name, item.index,
        translate_heavenly_stem(item.heavenly_stem, Language::ZhCN),
        translate_earthly_branch(item.earthly_branch, Language::ZhCN));
}
println!("小限虚岁 {}", h.age.nominal_age);

大限 落在宫位 2 干支 庚辰
流月 落在宫位 3 干支 壬午
流日 落在宫位 8 干支 辛丑
流时 落在宫位 8 干支 戊子
小限虚岁 26

pub struct DecadalHoroscope {
    pub base: HoroscopeItem,
    pub palace_name: Palace,     // 该大限所在的本命宫名
    pub age_range: (u32, u32),   // 起止虚岁，含两端
    pub year_range: (i64, i64),  // 起止农历年份，含两端
}

pub struct YearlyHoroscope {
    pub base: HoroscopeItem,
    pub age: u32,                // 该流年对应的虚岁
    pub year: i64,               // 农历年份
}

pub struct MonthlyHoroscope {
    pub base: HoroscopeItem,
    pub age: u32,                // 该流月对应的虚岁
    pub year: i64,               // 农历年份
    pub month: u32,              // 农历月份，正月为 1；闰月与同号常规月的 month 相同
    pub is_leap_month: bool,     // 该项是否闰月
    pub part: MonthPart,         // Normal 整月 / First 闰月前半 / Second 闰月后半
    pub day_range: (u32, u32),   // 该段覆盖的农历日，含两端
}

pub fn decadal_list(&self) -> Vec<DecadalHoroscope>

let zh = Language::ZhCN;

for d in chart.decadal_list().iter().take(3) {
    println!("{} {}{} {}-{} {}-{}",
        translate_palace(d.palace_name, zh),
        translate_heavenly_stem(d.heavenly_stem, zh),
        translate_earthly_branch(d.earthly_branch, zh),
        d.age_range.0, d.age_range.1, d.year_range.0, d.year_range.1);
}
println!("{}", chart.decadal_list().len());

命宫 壬午 3-12 2002-2011
兄弟 辛巳 13-22 2012-2021
夫妻 庚辰 23-32 2022-2031
12

pub fn yearly_list(&self, target: impl Into<DecadalTarget>) -> Result<Vec<YearlyHoroscope>, IztroError>

pub enum DecadalTarget {
    Ordinal(usize),  // 起运先后序号
    Name(Palace),    // 该大限所在的本命宫名
}

let zh = Language::ZhCN;
let list = chart.yearly_list(2usize)?;

for y in list.iter().take(3) {
    println!("{} {} {}{} -> {}", y.age, y.year,
        translate_heavenly_stem(y.heavenly_stem, zh),
        translate_earthly_branch(y.earthly_branch, zh), y.index);
}
println!("{} {}", list.len(), chart.yearly_list(Palace::Spouse)?.len());

23 2022 壬寅 -> 0
24 2023 癸卯 -> 1
25 2024 甲辰 -> 2
10 10

pub fn monthly_list(&self, year: i64, fix_leap: bool) -> Result<Vec<MonthlyHoroscope>, IztroError>

let zh = Language::ZhCN;
let list = chart.monthly_list(2020, true)?;

println!("{}", list.len());
for m in list.iter().skip(3).take(4) {
    println!("{} {} {} {}-{} {}{}", m.month, m.is_leap_month, m.part.as_key(),
        m.day_range.0, m.day_range.1,
        translate_heavenly_stem(m.heavenly_stem, zh),
        translate_earthly_branch(m.earthly_branch, zh));
}
println!("{} {}", chart.monthly_list(2020, false)?.len(), chart.monthly_list(2021, true)?.len());

14
4 false normal 1-30 辛巳
4 true first 1-15 辛巳
4 true second 16-29 壬午
5 false normal 1-30 壬午
13 12

pub fn age_palace(&self) -> PalaceRef<'a>

let h = chart.horoscope("2025-6-1", 0)?;
println!("{}", translate_palace(h.age_palace().name, Language::ZhCN));

田宅

pub fn palace(&self, name: Palace, scope: Scope) -> Option<PalaceRef<'a>>

let zh = Language::ZhCN;
let h = chart.horoscope("2025-6-1", 0)?;

println!("大限命宫落在本命的 {}",
    translate_palace(h.palace(Palace::Soul, Scope::Decadal).unwrap().name, zh));
println!("本命命宫是 {}",
    translate_palace(h.palace(Palace::Soul, Scope::Origin).unwrap().name, zh));

大限命宫落在本命的 夫妻
本命命宫是 命宫

pub fn surround_palaces(&self, name: Palace, scope: Scope) -> Option<SurroundedPalaces<'a>>

let h = chart.horoscope("2025-6-1", 0)?;
let sp = h.surround_palaces(Palace::Wealth, Scope::Yearly).unwrap();

println!("流年财帛的三方四正以本命 {} 为本宫", translate_palace(sp.target.name, Language::ZhCN));

流年财帛的三方四正以本命 疾厄 为本宫

pub fn has_horoscope_stars(&self, name: Palace, scope: Scope, stars: &[StarKey]) -> bool
pub fn has_one_of_horoscope_stars(&self, name: Palace, scope: Scope, stars: &[StarKey]) -> bool
pub fn not_have_horoscope_stars(&self, name: Palace, scope: Scope, stars: &[StarKey]) -> bool

use x_iztro::StarKey::*;

let h = chart.horoscope("2025-6-1", 0)?;

println!("{}", h.has_horoscope_stars(Palace::Soul, Scope::Decadal, &[Yunlu]));
println!("{}", h.has_one_of_horoscope_stars(Palace::Soul, Scope::Decadal, &[Yunlu, Yunyang]));
println!("{}", h.not_have_horoscope_stars(Palace::Soul, Scope::Decadal, &[Yuntuo]));

false
false
true

pub fn has_horoscope_mutagen(&self, name: Palace, scope: Scope, mutagen: Mutagen) -> bool

let h = chart.horoscope("2025-6-1", 0)?;

println!("{}", h.has_horoscope_mutagen(Palace::Soul, Scope::Decadal, Mutagen::Lu));

// 该层级化出的四颗星本身可直接读
println!("{:?}", h.decadal.mutagen.iter()
    .map(|s| translate_star(*s, Language::ZhCN)).collect::<Vec<_>>());

false
["太阳", "武曲", "太阴", "天同"]

pub fn astrolabe(&self) -> &'a Astrolabe
pub fn data(&self) -> &HoroscopeData
pub fn into_data(self) -> HoroscopeData

let h = chart.horoscope("2025-6-1", 0)?;

println!("{}", h.astrolabe().solar_date);

let data: HoroscopeData = h.into_data();   // 不再借用 chart
println!("{}", data.solar_date);

2000-8-16
2025-6-1

pub fn to_text(&self) -> String

let h = chart.horoscope("2025-1-1", 0)?;

for line in h.to_text().lines().take(5) {
    println!("{line}");
}

# 运限 2025-1-1 (二〇二四年腊月初二)

## 大限 · 命宫: 本命夫妻 (庚辰)
- 四化: 太阳化禄→本命子女, 武曲化权→本命财帛, 太阴化科→本命仆役, 天同化忌→本命疾厄
- 格局: 杀破狼 (命宫), 风云际会 (命宫)

pub fn to_text_with(&self, opts: &TextOptions) -> String

let pack = KnowledgePack::builtin(Language::ZhCN).unwrap();
let h = chart.horoscope("2025-1-1", 0)?;
let text = h.to_text_with(&TextOptions::new().knowledge(pack));

println!("{} {}", h.to_text().chars().count(), text.chars().count());
for line in text.lines().filter(|l| l.starts_with("## ")) {
    println!("{line}");
}

2457 8458
## 大限 · 命宫: 本命夫妻 (庚辰)
## 小限 · 命宫: 本命官禄 · 虚岁 25
## 流年 · 命宫: 本命夫妻 (甲辰)
## 流月 · 命宫: 本命仆役 (丁丑)
## 流日 · 命宫: 本命迁移 (庚午)
## 流时 · 命宫: 本命迁移 (丙子)

pub fn to_dto(&self, lang: Language) -> HoroscopeDto

let h = chart.horoscope("2025-6-1", 0)?;
let json = serde_json::to_string(&h.to_dto(chart.language))?;
let v: serde_json::Value = serde_json::from_str(&json)?;

println!("{} {}", v["solarDate"], v["decadal"]["heavenlyStem"]);
println!("{}", v["age"]["nominalAge"]);

"2025-6-1" "庚"
26