v1.1.8 新增灶马头；修复月九星计算错误的问题；修复九星错别字；修复宜忌错别字。

Author: 6tail

CHANGELOG.md

@@ -59,3 +59,9 @@
 ## [1.1.7] - 2025-01-15
 1. 修复：农历季节报错的问题。
 2. 优化：增强兼容性。
+
+## [1.1.8] - 2025-02-16
+1. 新增：灶马头 KitchenGodSteed。
+2. 修复：月九星计算错误的问题。
+3. 修复：九星错别字。
+4. 修复：宜忌错别字。

src/LoopTyme.php

@@ -101,4 +101,15 @@ protected function nextIndex(int $n): int
         return $this->indexOf($this->index + $n);
     }
 
+    /**
+     * 到目标索引的步数
+     *
+     * @param int $targetIndex 目标索引
+     * @return int 步数
+     */
+    function stepsTo(int $targetIndex): int
+    {
+        return $this->indexOf($targetIndex - $this->index);
+    }
+
 }

src/culture/KitchenGodSteed.php

@@ -0,0 +1,188 @@
+<?php
+
+namespace com\tyme\culture;
+
+use com\tyme\AbstractCulture;
+use com\tyme\lunar\LunarDay;
+use com\tyme\sixtycycle\SixtyCycle;
+
+/**
+ * 灶马头
+ * @author 6tail
+ * @package com\tyme\culture
+ */
+class KitchenGodSteed extends AbstractCulture
+{
+    static array $NUMBERS = ["一", "二", "三", "四", "五", "六", "七", "八", "九", "十", "十一", "十二"];
+
+    /**
+     * 正月初一的干支
+     * @var SixtyCycle
+     */
+    protected SixtyCycle $firstDaySixtyCycle;
+
+    function __construct(int $lunarYear)
+    {
+        $this->firstDaySixtyCycle = LunarDay::fromYmd($lunarYear, 1, 1)->getSixtyCycle();
+    }
+
+    static function fromLunarYear(int $lunarYear): KitchenGodSteed
+    {
+        return new self($lunarYear);
+    }
+
+    protected function byHeavenStem(int $n): string
+    {
+        return self::$NUMBERS[$this->firstDaySixtyCycle->getHeavenStem()->stepsTo($n)];
+    }
+
+    protected function byEarthBranch(int $n): string
+    {
+        return self::$NUMBERS[$this->firstDaySixtyCycle->getEarthBranch()->stepsTo($n)];
+    }
+
+    /**
+     * 几鼠偷粮
+     *
+     * @return string 几鼠偷粮
+     */
+    function getMouse(): string
+    {
+        return sprintf("%s鼠偷粮", $this->byEarthBranch(0));
+    }
+
+    /**
+     * 草子几分
+     *
+     * @return string 草子几分
+     */
+    function getGrass(): string
+    {
+        return sprintf("草子%s分", $this->byEarthBranch(0));
+    }
+
+    /**
+     * 几牛耕田（正月第一个丑日是初几，就是几牛耕田）
+     *
+     * @return string 几牛耕田
+     */
+    function getCattle(): string
+    {
+        return sprintf("%s牛耕田", $this->byEarthBranch(1));
+    }
+
+    /**
+     * 花收几分
+     *
+     * @return string 花收几分
+     */
+    function getFlower(): string
+    {
+        return sprintf("花收%s分", $this->byEarthBranch(3));
+    }
+
+    /**
+     * 几龙治水（正月第一个辰日是初几，就是几龙治水）
+     *
+     * @return string 几龙治水
+     */
+    function getDragon(): string
+    {
+        return sprintf("%s龙治水", $this->byEarthBranch(4));
+    }
+
+    /**
+     * 几马驮谷
+     *
+     * @return string 几马驮谷
+     */
+    function getHorse(): string
+    {
+        return sprintf("%s马驮谷", $this->byEarthBranch(6));
+    }
+
+    /**
+     * 几鸡抢米
+     *
+     * @return string 几鸡抢米
+     */
+    function getChicken(): string
+    {
+        return sprintf("%s鸡抢米", $this->byEarthBranch(9));
+    }
+
+    /**
+     * 几姑看蚕
+     *
+     * @return string 几姑看蚕
+     */
+    function getSilkworm(): string
+    {
+        return sprintf("%s姑看蚕", $this->byEarthBranch(9));
+    }
+
+    /**
+     * 几屠共猪
+     *
+     * @return string 几屠共猪
+     */
+    function getPig(): string
+    {
+        return sprintf("%s屠共猪", $this->byEarthBranch(11));
+    }
+
+    /**
+     * 甲田几分
+     *
+     * @return string 甲田几分
+     */
+    function getField(): string
+    {
+        return sprintf("甲田%s分", $this->byHeavenStem(0));
+    }
+
+    /**
+     * 几人分饼（正月第一个丙日是初几，就是几人分饼）
+     *
+     * @return string 几人分饼
+     */
+    function getCake(): string
+    {
+        return sprintf("%s人分饼", $this->byHeavenStem(2));
+    }
+
+    /**
+     * 几日得金（正月第一个辛日是初几，就是几日得金）
+     *
+     * @return string 几日得金
+     */
+    function getGold(): string
+    {
+        return sprintf("%s日得金", $this->byHeavenStem(7));
+    }
+
+    /**
+     * 几人几丙
+     *
+     * @return string 几人几丙
+     */
+    function getPeopleCakes(): string
+    {
+        return sprintf("%s人%s丙", $this->byEarthBranch(2), $this->byHeavenStem(2));
+    }
+
+    /**
+     * 几人几锄
+     *
+     * @return string 几人几锄
+     */
+    function getPeopleHoes(): string
+    {
+        return sprintf("%s人%s锄", $this->byEarthBranch(2), $this->byHeavenStem(3));
+    }
+
+    function getName(): string
+    {
+        return "灶马头";
+    }
+}

src/culture/Taboo.php

@@ -13,7 +13,7 @@
  */
 class Taboo extends LoopTyme
 {
-    static array $NAMES = ['祭祀', '祈福', '求嗣', '开光', '塑绘', '齐醮', '斋醮', '沐浴', '酬神', '造庙', '祀灶', '焚香', '谢土', '出火', '雕刻', '嫁娶', '订婚', '纳采', '问名', '纳婿', '归宁', '安床', '合帐', '冠笄', '订盟', '进人口', '裁衣', '挽面', '开容', '修坟', '启钻', '破土', '安葬', '立碑', '成服', '除服', '开生坟', '合寿木', '入殓', '移柩', '普渡', '入宅', '安香', '安门', '修造', '起基', '动土', '上梁', '竖柱', '开井开池', '作陂放水', '拆卸', '破屋', '坏垣', '补垣', '伐木做梁', '作灶', '解除', '开柱眼', '穿屏扇架', '盖屋合脊', '开厕', '造仓', '塞穴', '平治道涂', '造桥', '作厕', '筑堤', '开池', '伐木', '开渠', '掘井', '扫舍', '放水', '造屋', '合脊', '造畜稠', '修门', '定磉', '作梁', '修饰垣墙', '架马', '开市', '挂匾', '纳财', '求财', '开仓', '买车', '置产', '雇庸', '出货财', '安机械', '造车器', '经络', '酝酿', '作染', '鼓铸', '造船', '割蜜', '栽种', '取渔', '结网', '牧养', '安碓磑', '习艺', '入学', '理发', '探病', '见贵', '乘船', '渡水', '针灸', '出行', '移徙', '分居', '剃头', '整手足甲', '纳畜', '捕捉', '畋猎', '教牛马', '会亲友', '赴任', '求医', '治病', '词讼', '起基动土', '破屋坏垣', '盖屋', '造仓库', '立券交易', '交易', '立券', '安机', '会友', '求医疗病', '诸事不宜', '馀事勿取', '行丧', '断蚁', '归岫'];
+    static array $NAMES = ['祭祀', '祈福', '求嗣', '开光', '塑绘', '齐醮', '斋醮', '沐浴', '酬神', '造庙', '祀灶', '焚香', '谢土', '出火', '雕刻', '嫁娶', '订婚', '纳采', '问名', '纳婿', '归宁', '安床', '合帐', '冠笄', '订盟', '进人口', '裁衣', '挽面', '开容', '修坟', '启钻', '破土', '安葬', '立碑', '成服', '除服', '开生坟', '合寿木', '入殓', '移柩', '普渡', '入宅', '安香', '安门', '修造', '起基', '动土', '上梁', '竖柱', '开井开池', '作陂放水', '拆卸', '破屋', '坏垣', '补垣', '伐木做梁', '作灶', '解除', '开柱眼', '穿屏扇架', '盖屋合脊', '开厕', '造仓', '塞穴', '平治道涂', '造桥', '作厕', '筑堤', '开池', '伐木', '开渠', '掘井', '扫舍', '放水', '造屋', '合脊', '造畜稠', '修门', '定磉', '作梁', '修饰垣墙', '架马', '开市', '挂匾', '纳财', '求财', '开仓', '买车', '置产', '雇佣', '出货财', '安机械', '造车器', '经络', '酝酿', '作染', '鼓铸', '造船', '割蜜', '栽种', '取渔', '结网', '牧养', '安碓磑', '习艺', '入学', '理发', '探病', '见贵', '乘船', '渡水', '针灸', '出行', '移徙', '分居', '剃头', '整手足甲', '纳畜', '捕捉', '畋猎', '教牛马', '会亲友', '赴任', '求医', '治病', '词讼', '起基动土', '破屋坏垣', '盖屋', '造仓库', '立券交易', '交易', '立券', '安机', '会友', '求医疗病', '诸事不宜', '馀事勿取', '行丧', '断蚁', '归岫'];
 
     /**
      * @var string[] 每日宜忌数据

src/culture/star/nine/NineStar.php

@@ -47,7 +47,7 @@ function next(int $n): static
      */
     function getColor(): string
     {
-        return ['白', '黒', '碧', '绿', '黄', '白', '赤', '白', '紫'][$this->index];
+        return ['白', '黑', '碧', '绿', '黄', '白', '赤', '白', '紫'][$this->index];
     }
 
     /**

src/lunar/LunarMonth.php

@@ -345,7 +345,11 @@ function getSixtyCycle(): SixtyCycle
      */
     function getNineStar(): NineStar
     {
-        return NineStar::fromIndex(27 - $this->year->getSixtyCycle()->getEarthBranch()->getIndex() % 3 * 3 - $this->getSixtyCycle()->getEarthBranch()->getIndex());
+        $index = $this->getSixtyCycle()->getEarthBranch()->getIndex();
+        if ($index < 2) {
+            $index += 3;
+        }
+        return NineStar::fromIndex(27 - $this->year->getSixtyCycle()->getEarthBranch()->getIndex() % 3 * 3 - $index);
     }
 
     /**

src/lunar/LunarYear.php

@@ -5,6 +5,7 @@
 
 use com\tyme\AbstractTyme;
 use com\tyme\culture\Direction;
+use com\tyme\culture\KitchenGodSteed;
 use com\tyme\culture\star\nine\NineStar;
 use com\tyme\culture\Twenty;
 use com\tyme\sixtycycle\SixtyCycle;
@@ -192,4 +193,14 @@ function getMonths(): array
         }
         return $l;
     }
+
+    /**
+     * 灶马头
+     *
+     * @return KitchenGodSteed 灶马头
+     */
+    function getKitchenGodSteed(): KitchenGodSteed
+    {
+        return KitchenGodSteed::fromLunarYear($this->year);
+    }
 }

src/solar/SolarDay.php

@@ -270,16 +270,12 @@ function getPhenologyDay(): PhenologyDay
      */
     function getDogDay(): ?DogDay
     {
+        // 夏至
         $xiaZhi = SolarTerm::fromIndex($this->getYear(), 12);
         // 第1个庚日
         $start = $xiaZhi->getJulianDay()->getSolarDay();
-        $add = 6 - $start->getLunarDay()->getSixtyCycle()->getHeavenStem()->getIndex();
-        if ($add < 0) {
-            $add += 10;
-        }
         // 第3个庚日，即初伏第1天
-        $add += 20;
-        $start = $start->next($add);
+        $start = $start->next($start->getLunarDay()->getSixtyCycle()->getHeavenStem()->stepsTo(6) + 20);
         $days = $this->subtract($start);
         // 初伏以前
         if ($days < 0) {
@@ -376,22 +372,14 @@ function getPlumRainDay(): ?PlumRainDay
         // 芒种
         $grainInEar = SolarTerm::fromIndex($this->getYear(), 11);
         $start = $grainInEar->getJulianDay()->getSolarDay();
-        $add = 2 - $start->getLunarDay()->getSixtyCycle()->getHeavenStem()->getIndex();
-        if ($add < 0) {
-            $add += 10;
-        }
         // 芒种后的第1个丙日
-        $start = $start->next($add);
+        $start = $start->next($start->getLunarDay()->getSixtyCycle()->getHeavenStem()->stepsTo(2));
 
         // 小暑
         $slightHeat = $grainInEar->next(2);
         $end = $slightHeat->getJulianDay()->getSolarDay();
-        $add = 7 - $end->getLunarDay()->getSixtyCycle()->getEarthBranch()->getIndex();
-        if ($add < 0) {
-            $add += 12;
-        }
         // 小暑后的第1个未日
-        $end = $end->next($add);
+        $end = $end->next($end->getLunarDay()->getSixtyCycle()->getEarthBranch()->stepsTo(7));
 
         if ($this->isBefore($start) || $this->isAfter($end)) {
             return null;

test/KitchenGodSteedTest.php

@@ -0,0 +1,16 @@
+<?php
+
+use com\tyme\culture\KitchenGodSteed;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * 灶马头测试
+ * @author 6tail
+ */
+class KitchenGodSteedTest extends TestCase
+{
+    function test0()
+    {
+        $this->assertEquals('二龙治水', KitchenGodSteed::fromLunarYear(2017)->getDragon());
+    }
+}

test/NineStarTest.php

@@ -51,7 +51,7 @@ function test4()
     function test5()
     {
         $nineStar = LunarMonth::fromYm(2022, 1)->getNineStar();
-        $this->assertEquals('二黒土', $nineStar->__toString());
+        $this->assertEquals('二黑土', $nineStar->__toString());
         $this->assertEquals('天璇', $nineStar->getDipper()->__toString());
     }