@lunisolar/plugin-char8ex

lunisolar.js的八字增强插件

lunisolar.js文档请进入lunisolar.js.org

• @lunisolar/plugin-char8ex
  • 简介
  • 快速上手
  • Char8Ex类
  • Pillar 四柱类
  • C8God 四柱神煞类
  • TenGod 十神类

简介

lunisolar.js本身可能过Lunisolar实例的char8属性实现基本的八字查询功能, 但未包括十神和神煞等功能。使用Char8Ex插件后，将会在Lunisolar``实例上添加一个char8ex()方法, 除了包含原char8的功能外，还加入了十神和神煞的查询。

/**
 * @param sex 性别 0:坤造，1: 乾造
 * @return 返回一个Char8Ex实例对象
 */
lunisolar().char8ex(sex: 0 | 1): Char8Ex

注意：加载char8ex插件时，将自动加载takeSound插件（五行纳音插件），所以请不要再重复加载takeSound

快速上手

安装：

# 由于八字增强插件虽要用到五行纳音，所以同时安装五行纳音插件
npm add @lunisolar/plugin-char8ex @lunisolar/plugin-takesound

// 引入lunisolar
import lunisolar from 'lunisolar'
// 引入 theGods 插件
import { char8ex } from '@lunisolar/plugin-char8ex'
// 加载插件 （加载char8ex时，takesound插件也会自动加载）
lunisolar.extend(char8ex)


// ---  使用
// 创建一个Char8Ex实例对象, 该八字为 2023-01-15 12:26出生的男孩
const c8ex =  lunisolar('2023-01-15 12:26').char8ex(1)

console.log(c8ex.toString()) // 乾造: 壬寅 癸丑 癸酉 戊午

// Char8Ex实例可通过year,month,day,hour属性取得四柱实例 Pillar
// 而每个四柱实例（Pillar）又包含纳音、天干、地支、天干十神、地支十神、四柱神煞等功能查询

// 取各柱天干十神, 十神和神煞都是以对象形式存在
console.log(c8ex.year.stemTenGod.name) // 劫財
console.log(c8ex.month.stemTenGod.name) // 比肩
// 注：日主实际并不是十神之一，它位于日柱天干，十神以此推算。
console.log(c8ex.day.stemTenGod.name) // 日主
console.log(c8ex.hour.stemTenGod.name) // 正官

// 取各柱地支藏干十神
// 地支十神通过地支所藏天干推算，所以各柱的地支十神可能存在的个数为1至3个，故以数组形式返回
console.log(c8ex.year.branchTenGod.map(i => i.name)) // [ '傷官', '正財', '正官' ]
console.log(c8ex.month.branchTenGod.map(i => i.name)) // ['七殺', '比肩', '梟神']
console.log(c8ex.day.branchTenGod.map(i => i.name)) // ['梟神']
console.log(c8ex.hour.branchTenGod.map(i => i.name)) // ['偏財', '七殺']

//取年柱纳音
console.log(c8ex.year.takeSound) // 金箔金

//空亡地支 missing属性返回一个元组，该元组包含两个地支实例： [Branch, Branch]
// c8ex.missing 等同于 c8ex.day.missing
console.log(c8ex.missing.map(i => i.name)) //  [ '戌', '亥' ]

// 取得年柱上的神煞,其它柱类似
console.log(c8ex.year.gods.map(item => item.name)) // ['文昌貴人', '金輿', '天廚貴人', '劫煞']

:::tip char8ex插件默认语言与lunisolar一样为繁体中文，如需要其它语言，须再另外加载 :::

Char8Ex类

通过 lunisolar().char8ex(sex: 0 | 1): Char8Ex取得Char8Ex实例

为什么char8ex方法要设置性别参数？

因为个别神煞的计算方法男女不同。

属性或方法	描述	参数	返回类型
me	取得日主		Stem
sexValue	取得性别值		0 | 1
sex	取得性别 如'乾造' 或 '坤造'	string
year	取得年柱对象		Pillar
month	取得月柱对象		Pillar
day	取得日柱对象		Pillar
hour	取得时柱对象		Pillar
gods	取得各柱所有神煞		{year: C8God[], month: C8God[], day: C8God[], hour: C8God[]}
list	四柱列表	[Pillar, Pillar, Pillar, Pillar]
embryo()	胎元, 返回一个天干地支对象	SB
ownSign()	命宫, 返回一个天干地支对象	SB
bodySign()	身宫, 返回一个天干地支对象	SB
toString()	返回八字的基本信息描述	SB

Pillar 四柱类

四柱类是SB类的增强版,主要补充了十神和神煞等属性

属性或方法	描述	参数	返回类型
gods	返回该柱所算出的所有神煞		C8God[]
stem	该柱天干		Stem
branch	该柱地支		Branch
value	该天干地支组合的索引值, 范围[0, 59]	number
name	该天干地支组合的字符串, 如 甲子	string
takeSound	取得五行纳音描述		string
takeSoundE5	取得五行纳音的五行对象		Element5
stemTenGod	取得天干十神		TenGod
branchTenGod	取得地支十神, 因为是按地支藏干算的, 所以返回提一个列表		TenGod[]
missing	返回旬空地支		[Branch, Branch]
toString()	该天干地支组合的字符串, 等同于name属性		string

C8God 四柱神煞类

属性或方法	描述	参数	返回类型
luckLevel	吉凶等级, 1为吉, -1凶, 0不定		number
key	该神煞的key(以繁体中文神煞名作为key)		string
name	该神煞名		string
toString()	该天干地支组合的字符串, 等同于name属性		string

TenGod 十神类

属性或方法	描述	参数	返回类型
key	该十神的key(以繁体中文神煞名作为key)		string
name	该十神名称		string
toString()	该天干地支组合的字符串, 等同于name属性		string