宫位

前言

紫微斗数中一共有 十二 个宫位，叫做 十二人事宫，囊括了与人有关的其他人和事物，这十二宫按顺序分别是 命宫、兄弟宫、夫妻宫、子女宫、财帛宫、疾厄宫、迁移宫、仆役宫、官禄宫、田宅宫、福德宫、父母宫。除了这展示在星盘里的十二宫以外，紫微斗数还有三个隐藏宫位，它们分别是 身宫、来因宫、暗合宫。每一个宫位有着它特殊的意义，但本页不详细展开来叙述。如果你对紫微斗数的宫位没有概念，或者想深入研究，可以点击宫位系统查看详细资料。与宫位地支顺时针排列相反，宫位名称是按逆时针排列的。如下面表格所示：

巳 `田宅`	午 `官禄`	未 `仆役`	申 `迁移`
辰 `福德`	中宫		酉 `疾厄`
卯 `父母`	中宫		戌 `财帛`
寅 `命宫`	丑 `兄弟`	子 `夫妻`	亥 `子女`

以上表格只是一个例子，命宫 的位置会根据你的 出生日期 和 出生时间 的不同而不同，它可能出现在上述任何一个宫位，但这个顺序是不会变的。

宫位其实是 宫 和 位 两个概念组成的，通过 出生日期 和 出生时间 计算出来的，叫 宫，所以你星盘中的 财帛宫 位置在本命盘中是固定的，如果你不知道什么叫 本命盘，我们强烈建议你点击基础知识扫盲学习。位 则是一个 相对 位置，比如 夫妻宫 的 财帛位 是 迁移宫。这听起来有些绕，好消息是，你不需要记忆这些烧脑的信息，只需要有这么一个概念就可以了。

功能类定义

开发建议

因为宫位是基于星盘而存在的，所以我们并不推荐你手动 new 一个宫位对象，而是使用星盘静态方法返回的对象使用。星盘的 palaces 属性包含了十二宫的数据，为了和地支的顺序保持一致，它是从 寅宫 开始按照地支顺序顺时针排列的。

import { astro } from "iztro";

const astrolabe = astro.astrolabeBySolarDate("2000-8-16", 2, "女", true, "zh-CN");

你可以有几种方式从上述 astrolabe 变量里获取到目标宫位，请根据实际需求使用：

通过 palaces 的下标获取

// 获取卯宫宫位
const palace = astrolabe.palaces[1];

通过 FunctionalAstrolabe 类的 palace() 方法传入宫位 索引 获取
ts
```
// 获取卯宫宫位
const palace = astrolabe.palace(1);
```
通过 FunctionalAstrolabe 类的 palace() 方法传入宫位 名称 获取
ts
```
// 获取命宫
const palace = astrolabe.palace("命宫");
```

FunctionalPalace

implements IFuncionalPalace extends Palace

该类所有属性都是继承自 Palace，然后在接口内定义了一些方法用于对星曜进行分析。

接口定义

interface IFunctionalPalace extends Palace {
  has: (stars: StarName[]) => boolean;
  notHave: (stars: StarName[]) => boolean;
  hasOneOf: (stars: StarName[]) => boolean;
  hasMutagen: (mutagen: Mutagen): boolean;
  notHaveMutagen: (mutagen: Mutagen): boolean;
  isEmpty: (excludeStars?: StarName[]) => boolean;
  astrolabe: () => IFunctionalAstrolabe | undefined;
  fliesTo: (to: number | PalaceName, withMutagens: Mutagen | Mutagen[]) => boolean;
  fliesOneOfTo: (to: number | PalaceName, withMutagens: Mutagen[]) => boolean;
  notFlyTo: (to: number | PalaceName, withMutagens: Mutagen | Mutagen[]) => boolean;
  selfMutaged: (withMutagens: Mutagen | Mutagen[]) => boolean;
  selfMutagedOneOf: (withMutagens?: Mutagen[]) => boolean;
  notSelfMutaged: (withMutagens?: Mutagen | Mutagen[]) => boolean;
  mutagedPlaces: () => (IFunctionalPalace | undefined)[];
}

属性
参考 Palace
方法
has() ^1.0.0
- 用途
  判断某个宫位内是否有传入的 星曜，要 所有 星曜 都在 宫位内才会返回 true
- 定义
  ts
```
type has = (stars: StarName[]) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  stars StarName[] true - 星曜名称，可以包含主星、辅星、杂耀
- 返回值
  boolean
- 示例
  如果你想查看 命宫 是否有 紫微星 和 右弼星
  ts
```
const palace = astrolabe.palace("命宫");
const result = palace.has(["紫微", "右弼"]);
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.palace("命宫").has(["紫微", "右弼"]);
```
notHave() ^1.0.0
- 用途
  判断某个宫位内是否没有传入的 星曜，要所有星曜 都不在 宫位内才会返回 true
- 定义
  ts
```
type notHave = (stars: StarName[]) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  stars StarName[] true - 星曜名称，可以包含主星、辅星、杂耀
- 返回值
  boolean
- 示例
  如果你想查看 命宫 是没有 地空星 和 地劫星
  ts
```
const palace = astrolabe.palace("命宫");
const result = palace.notHave(["地空", "地劫"]);
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.palace("命宫").notHave(["地空", "地劫"]);
```
hasOneOf() ^1.0.0
- 用途
  判断某个宫位内是否有传入 星曜 的其中一个，只要 命中一个 就会返回 true
- 定义
  ts
```
type hasOneOf = (stars: StarName[]) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  stars StarName[] true - 星曜名称，可以包含主星、辅星、杂耀
- 返回值
  boolean
- 示例
  如果你想查看 命宫 是否有 天魁星 或 天钺星
  ts
```
const palace = astrolabe.palace("命宫");
const result = palace.hasOneOf(["天魁", "天钺"]);
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.palace("命宫").hasOneOf(["天魁", "天钺"]);
```
hasMutagen() ^1.2.0
- 用途
  判断宫位内是否有生年四化
- 定义
  ts
```
type hasMutagen = (mutagen: Mutagen) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  mutagen Mutagen true - 四化名称【禄｜权｜科｜忌】
- 返回值
  boolean
- 示例
  如果你想查看 命宫 是否有 化禄
  ts
```
const palace = astrolabe.palace("命宫");
const result = palace.hasMutagen("禄");
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.palace("命宫").hasMutagen("禄");
```
notHaveMutagen() ^1.2.0
- 用途
  判断宫位内是否没有生年四化
- 定义
  ts
```
type notHaveMutagen = (mutagen: Mutagen) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  mutagen Mutagen true - 四化名称【禄｜权｜科｜忌】
- 返回值
  boolean
- 示例
  如果你想查看 命宫 是不是没有 化忌
  ts
```
const palace = astrolabe.palace("命宫");
const result = palace.notHaveMutagen("忌");
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.palace("命宫").notHaveMutagen("忌");
```
isEmpty() ^2.0.6
- 用途
  判断一个宫位是否为空宫（没有主星），有些派别在宫位内有某些星曜的情况下，是不会将该宫位判断为空宫的。所以加入一个参数来传入星曜。
- 定义
  ts
```
type isEmpty = (excludeStars?: StarName[]) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  excludeStars StarName[] false - 星曜名称数组
- 返回值
  boolean
astrolabe() ^2.1.0
- 用途
  获取当前宫位所在的星盘对象。
- 定义
  ts
```
type astrolabe = () => IFunctionalAstrolabe | undefined;
```
- 参数
  无
- 返回值
IFunctionalAstrolabe | undefined;
fliesTo() ^2.1.0
- 用途
  判断是否从源宫位飞化到目标宫位，四化可传入一个数组或者一个字符串，传入四化全部飞化到目标宫位即返回 true
- 定义
  ts
```
type fliesTo = (
  to: number | PalaceName, 
  withMutagens: Mutagen | Mutagen[]
) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  to number | PalaceName true - 目标宫位索引或名称
  withMutagens Mutagen |Mutagen[] true - 四化（禄、权、科、忌）
- 返回值
  boolean
fliesOneOfTo() ^2.1.0
- 用途
  判断是否从源宫位飞化其中一颗四化星到目标宫位，传入四化只要有一颗飞化到目标宫位即返回 true
- 定义
  ts
```
type fliesOneOfTo = (
  to: number | PalaceName, 
  withMutagens: Mutagen | Mutagen[]
) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  to number | PalaceName true - 目标宫位索引或名称
  withMutagens Mutagen |Mutagen[] true - 四化（禄、权、科、忌）
- 返回值
  boolean
notFlyTo() ^2.1.0
- 用途
  判断是否没有从源宫位飞化到目标宫位，四化可传入一个数组或者一个字符串，传入四化全部没有飞化到目标宫位才返回 true
- 定义
  ts
```
type notFlyTo = (
  to: number | PalaceName, 
  withMutagens: Mutagen | Mutagen[]
) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  to number | PalaceName true - 目标宫位索引或名称
  withMutagens Mutagen |Mutagen[] true - 四化（禄、权、科、忌）
- 返回值
  boolean
selfMutaged() ^2.1.0
- 用途
  判断宫位是否有自化，传入四化数组时需要全部满足才返回 true
- 定义
  ts
```
type selfMutaged = (
  withMutagens: Mutagen | Mutagen[]
) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  withMutagens Mutagen |Mutagen[] true - 四化（禄、权、科、忌）
- 返回值
  boolean
selfMutagedOneOf() ^2.1.0
- 用途
  判断宫位是否有自化，若不传入参数则会判断所有四化，满足一颗即返回 true
- 定义
  ts
```
type selfMutagedOneOf = (
  withMutagens: Mutagen | Mutagen[]
) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  withMutagens Mutagen |Mutagen[] true - 四化（禄、权、科、忌）
- 返回值
  boolean
notSelfMutaged() ^2.1.0
- 用途
  判断宫位是否有自化，如果传入参数，则只判断传入的四化是否有自化，否则将会判断所有四化
- 定义
  ts
```
type notSelfMutaged = (
  withMutagens: Mutagen | Mutagen[]
) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  withMutagens Mutagen |Mutagen[] true - 四化（禄、权、科、忌）
- 返回值
  boolean
mutagedPlaces() ^2.1.0
- 用途
  获取当前宫位产生四化的4个宫位数组，下标分别对【禄，权，科，忌】
- 定义
  ts
```
type mutagedPlaces = () => (IFunctionalPalace | undefined)[];
```
- 参数
  无
- 返回值
  (IFunctionalPalace | undefined)[]

参数	类型	是否必填	默认值	说明
stars	`StarName[]`	`true`	-	星曜名称，可以包含主星、辅星、杂耀

参数	类型	是否必填	默认值	说明
stars	`StarName[]`	`true`	-	星曜名称，可以包含主星、辅星、杂耀

参数	类型	是否必填	默认值	说明
stars	`StarName[]`	`true`	-	星曜名称，可以包含主星、辅星、杂耀

参数	类型	是否必填	默认值	说明
mutagen	`Mutagen`	`true`	-	四化名称【禄｜权｜科｜忌】

参数	类型	是否必填	默认值	说明
mutagen	`Mutagen`	`true`	-	四化名称【禄｜权｜科｜忌】

参数	类型	是否必填	默认值	说明
excludeStars	`StarName[]`	`false`	-	星曜名称数组

参数	类型	是否必填	默认值	说明
to	`number` \| `PalaceName`	`true`	-	目标宫位索引或名称
withMutagens	`Mutagen` \|`Mutagen[]`	`true`	-	四化（禄、权、科、忌）

参数	类型	是否必填	默认值	说明
to	`number` \| `PalaceName`	`true`	-	目标宫位索引或名称
withMutagens	`Mutagen` \|`Mutagen[]`	`true`	-	四化（禄、权、科、忌）

参数	类型	是否必填	默认值	说明
to	`number` \| `PalaceName`	`true`	-	目标宫位索引或名称
withMutagens	`Mutagen` \|`Mutagen[]`	`true`	-	四化（禄、权、科、忌）

参数	类型	是否必填	默认值	说明
withMutagens	`Mutagen` \|`Mutagen[]`	`true`	-	四化（禄、权、科、忌）

参数	类型	是否必填	默认值	说明
withMutagens	`Mutagen` \|`Mutagen[]`	`true`	-	四化（禄、权、科、忌）

参数	类型	是否必填	默认值	说明
withMutagens	`Mutagen` \|`Mutagen[]`	`true`	-	四化（禄、权、科、忌）

FunctionalSurpalaces ^1.2.0

implements IFunctionalSurpalaces extends SurroundedPalaces

该类所有属性都是继承自 SurroundedPalaces，然后在接口内定义了一些方法用于对星曜进行分析。

接口定义

interface FunctionalSurpalaces extends SurroundedPalaces {
  have: (stars: StarName[]) => boolean;
  notHave: (stars: StarName[]) => boolean;
  haveOneOf: (stars: StarName[]) => boolean;
  haveMutagen: (mutagen: Mutagen) => boolean;
  notHaveMutagen: (mutagen: Mutagen): boolean;
}

属性
参考 SurroundedPalaces
方法
have()
- 用途
  判断某个宫三方四正内是否有传入的 星曜，要 所有 星曜 都在 三方四正内才会返回 true
- 定义
  ts
```
type have = (stars: StarName[]) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  stars StarName[] true - 星曜名称，可以包含主星、辅星、杂耀
- 返回值
  boolean
- 示例
  如果你想查看 命宫 三方四正是否有 紫微星 和 右弼星
  ts
```
const palaces = astrolabe.surroundedPalaces("命宫");
const result = palaces.have(["紫微", "右弼"]);
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.surroundedPalaces("命宫").have(["紫微", "右弼"]);
```
notHave()
- 用途
  判断某个宫三方四正内是否没有传入的 星曜，要所有星曜 都不在 三方四正内才会返回 true
- 定义
  ts
```
type notHave = (stars: StarName[]) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  stars StarName[] true - 星曜名称，可以包含主星、辅星、杂耀
- 返回值
  boolean
- 示例
  如果你想查看 命宫 三方四正是否没有 地空星 和 地劫星
  ts
```
const palaces = astrolabe.surroundedPalaces("命宫");
const result = palaces.notHave(["地空", "地劫"]);
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.surroundedPalaces("命宫").notHave(["地空", "地劫"]);
```
haveMutagen()
- 用途
  判断宫位三方四正内是否有生年四化
- 定义
  ts
```
type haveMutagen = (mutagen: Mutagen) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  mutagen Mutagen true - 四化名称【禄｜权｜科｜忌】
- 返回值
  boolean
- 示例
  如果你想查看 命宫 三方四正是否有 化禄
  ts
```
const palaces = astrolabe.surroundedPalaces("命宫");
const result = palaces.haveMutagen("禄");
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.surroundedPalaces("命宫").haveMutagen("禄");
```
notHaveMutagen()
- 用途
  判断宫位三方四正内是否没有生年四化
- 定义
  ts
```
type notHaveMutagen = (mutagen: Mutagen) => boolean;
```
- 参数
  参数类型是否必填默认值说明
  mutagen Mutagen true - 四化名称【禄｜权｜科｜忌】
- 返回值
  boolean
- 示例
  如果你想查看 命宫 三方四正是不是没有 化忌
  ts
```
const palace = astrolabe.surroundedPalaces("命宫");
const result = palace.notHaveMutagen("忌");
```
  当然你也可以使用 链式调用 来简化代码
  ts
```
const result = astrolabe.surroundedPalaces("命宫").notHaveMutagen("忌");
```

星曜知识

紫微斗数全书

宫位

前言

功能类定义

FunctionalPalace

has() ^1.0.0

notHave() ^1.0.0

hasOneOf() ^1.0.0

hasMutagen() ^1.2.0

notHaveMutagen() ^1.2.0

isEmpty() ^2.0.6

astrolabe() ^2.1.0

fliesTo() ^2.1.0

fliesOneOfTo() ^2.1.0

notFlyTo() ^2.1.0

selfMutaged() ^2.1.0

selfMutagedOneOf() ^2.1.0

notSelfMutaged() ^2.1.0

mutagedPlaces() ^2.1.0

FunctionalSurpalaces ^1.2.0

have()

notHave()

haveMutagen()

notHaveMutagen()

宫位 ​

前言 ​

功能类定义 ​

FunctionalPalace ​

has() ^1.0.0 ​

notHave() ^1.0.0 ​

hasOneOf() ^1.0.0 ​

hasMutagen() ^1.2.0 ​

notHaveMutagen() ^1.2.0 ​

isEmpty() ^2.0.6 ​

astrolabe() ^2.1.0 ​

fliesTo() ^2.1.0 ​

fliesOneOfTo() ^2.1.0 ​

notFlyTo() ^2.1.0 ​

selfMutaged() ^2.1.0 ​

selfMutagedOneOf() ^2.1.0 ​

notSelfMutaged() ^2.1.0 ​

mutagedPlaces() ^2.1.0 ​

FunctionalSurpalaces ^1.2.0 ​

have() ​

notHave() ​

haveMutagen() ​

notHaveMutagen() ​

宫位

前言

功能类定义

FunctionalPalace

has() ^1.0.0

notHave() ^1.0.0

hasOneOf() ^1.0.0

hasMutagen() ^1.2.0

notHaveMutagen() ^1.2.0

isEmpty() ^2.0.6

astrolabe() ^2.1.0

fliesTo() ^2.1.0

fliesOneOfTo() ^2.1.0

notFlyTo() ^2.1.0

selfMutaged() ^2.1.0

selfMutagedOneOf() ^2.1.0

notSelfMutaged() ^2.1.0

mutagedPlaces() ^2.1.0

FunctionalSurpalaces ^1.2.0

have()

notHave()

haveMutagen()

notHaveMutagen()