星曜 ​

前言 ​

星曜是紫微斗數裏的重要組成部分，人的個性主要受到星曜的影響。不同的星曜組合形成了不同的個性，如果你對星曜部分感興趣，我們強烈建議你點擊 紫微斗數星曜系統 進行相關知識學習。本篇主要關注的是開發層面。

功能類定義 ​

與 FunctionalAstrolabe 和 FunctionalPalace 一樣，我們並不建議你手動去創建一個 FunctionalStar 對象，而是使用其他對象返回的實例。

FunctionalStar ^1.2.0 ​

---

implements IFunctionalStar extends Star

• 接口定義

  ts

  interface IFunctionalStar extends Star {
    toJSON: () => Star;
    palace: () => IFunctionalPalace | undefined;
    setPalace: (p: IFunctionalPalace) => void;
    setAstrolabe: (a: IFunctionalAstrolabe) => void;
    surroundedPalaces: () => IFunctionalSurpalaces | undefined;
    oppositePalace: () => IFunctionalPalace | undefined;
    withBrightness: (brightness: Brightness | Brightness[]) => boolean;
    withMutagen: (mutagen: Mutagen | Mutagen[]) => boolean;
  }

• 屬性

  參考 Star

• 方法

  toJSON() ^2.6.0 ​

  • 用途

    將功能星曜轉換為普通 JSON 對象。返回結果不包含分析方法、關聯宮位和關聯星盤等運行時引用；循環引用會被安全忽略。

  • 定義

    ts

    type toJSON = () => Star;

  • 參數

    無

  • 返回值

    Star

  • 示例

    ts

    const data = astrolabe.star("紫微").toJSON();

  ---

  ❗️注意

  為了使 FunctionalStar 類使用起來更順暢，所以引入了 setPalace() 和 setAstrolabe() 兩個方法，但實際使用過程中請不要手動去調用這兩個方法，以免造成數據錯誤。

  palace() ​

  • 用途

    獲取星曜所在宮位

  • 定義

    ts

    type palace = () => IFunctionalPalace | undefined;

  • 參數

    none

  • 返回值

    FunctionalPalace | undefined

  • 示例

    獲取 紫微星 所在的宮位

    ts

    import { astro } from "iztro";
    
    const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");
    
    const palace = astrolabe.star("紫微").palace();

  ---

  surroundedPalaces() ​

  • 用途

    獲取當前星曜的三方四正宮位

  • 定義

    ts

    type surroundedPalaces = () => IFunctionalSurpalaces | undefined;

  • 參數

    none

  • 返回值

    FunctionalSurpalaces | undefined

  • 示例

    獲取 紫微星 的 三方四正 宮位

    ts

    import { astro } from "iztro";
    
    const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");
    
    const palaces = astrolabe.star("紫微").surroundedPalaces();

  ---

  oppositePalace() ​

  • 用途

    獲取當前星曜的對宮

  • 定義

    ts

    type oppositePalace = () => IFunctionalPalace | undefined;

  • 參數

    none

  • 返回值

    FunctionalPalace | undefined

  • 示例

    獲取 紫微星 的 對宮

    ts

    import { astro } from "iztro";
    
    const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");
    
    const palace = astrolabe.star("紫微").oppositePalace();

  ---

  withBrightness() ​

  • 用途

    判斷星曜是否是傳入的亮度，也可以傳入多個亮度，只要匹配到一個亮度就會返回 true

  • 定義

    ts

    type withBrightness = (brightness: Brightness | Brightness[]) => boolean;

  • 參數

  參數	類型	是否必填	默認值	說明
  brightness	Brightness | Brightness[]	true	-	需要判斷的星曜亮度

  • 返回值

    boolean

  • 示例

    判斷 紫微星 是否處於 廟 或者 旺 的狀態

    ts

    import { astro } from "iztro";
    
    const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");
    
    const result = astrolabe.star("紫微").withBrightness(["廟", "旺"]);

  ---

  withMutagen() ​

  • 用途

    判斷星曜是否產生了四化，也可以傳入多個四化進行判斷，只要匹配到一個四化就會返回 true

  • 定義

    ts

    type withMutagen = (mutagen: Mutagen | Mutagen[]) => boolean;

  • 參數

  參數	類型	是否必填	默認值	說明
  mutagen	Mutagen | Mutagen[]	true	-	四化【祿｜權｜科｜忌】

  • 返回值

    boolean

  • 示例

    判斷 紫微星 是否處於 化權 或者 化科 的狀態

    ts

    import { astro } from "iztro";
    
    const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");
    
    const result = astrolabe.star("紫微").withMutagen(["權", "科"]);