Paipan 项目使用教程

Paipan 项目使用教程

paipan PHP JavaScript 农历公历干支历互转,万年历,四柱,六十甲子,属相,十二星座,二十四节气,支持从-1000到3000年间的八字排盘及大运推算,支持真太阳时,支持分析刑冲合害关系 项目地址: https://gitcode.com/gh_mirrors/pa/paipan

1. 项目介绍

Paipan 是一个开源项目，主要用于 PHP 和 JavaScript 中的农历、公历、干支历的互转，以及万年历、四柱、六十甲子、属相、十二星座、二十四节气的计算。该项目支持从 -1000 年到 3000 年间的八字排盘及大运推算，并且支持真太阳时排盘，以及分析刑冲合害关系。

主要功能

• 农历公历互转：支持从 -104 年至 2300 年间的农历公历互转。
• 八字排盘：支持从 -1000 年至 3000 年间的八字排盘及大运推算。
• 二十四节气：支持二十四节气的计算，误差在 20 秒内。
• 真太阳时：支持真太阳时排盘，考虑了地球自转速度和倾角。
• 刑冲合害关系：支持分析八字中的刑冲合害关系。

2. 项目快速启动

2.1 环境准备

确保你已经安装了 PHP 和 Node.js 环境。

2.2 克隆项目

首先，克隆 Paipan 项目到本地：

git clone https://github.com/hkargv/paipan.git
cd paipan

2.3 安装依赖

进入项目目录后，安装所需的依赖：

npm install

2.4 运行示例代码

在 demo.php 文件中，你可以找到一些示例代码来测试项目的基本功能。以下是一个简单的示例：

<?php
require 'lib/paipan.php';

// 获取当前日期的农历
$lunarDate = Solar2Lunar(date('Y'), date('m'), date('d'));
echo "当前日期的农历是：" . $lunarDate['lunar_year'] . "年" . $lunarDate['lunar_month'] . "月" . $lunarDate['lunar_day'] . "日";

// 获取当前日期的八字
$baZi = GetGZ(date('Y'), date('m'), date('d'), date('H'), date('i'), date('s'));
echo "\n当前日期的八字是：" . $baZi['year'] . "年" . $baZi['month'] . "月" . $baZi['day'] . "日" . $baZi['hour'] . "时";
?>

2.5 运行代码

在终端中运行以下命令来执行 PHP 脚本：

php demo.php

3. 应用案例和最佳实践

3.1 农历生日提醒

你可以使用 Paipan 项目来创建一个农历生日提醒系统。用户输入他们的农历生日，系统会自动计算并提醒他们每年的公历生日。

3.2 八字排盘应用

开发一个八字排盘应用，用户输入出生日期和时间，应用会返回详细的八字信息，包括年柱、月柱、日柱、时柱，以及大运推算结果。

3.3 二十四节气提醒

利用 Paipan 项目中的二十四节气计算功能，开发一个节气提醒应用，用户可以订阅节气提醒，系统会在每个节气到来时发送通知。

4. 典型生态项目

4.1 寿星万年历

寿星万年历是一个广泛使用的农历和公历转换工具，Paipan 项目中的农历计算部分参考了寿星万年历的算法。

4.2 八字排盘工具

许多八字排盘工具都使用了类似的算法来计算八字和大运，Paipan 项目可以作为一个基础库，集成到这些工具中。

4.3 农历日历应用

许多日历应用需要支持农历显示，Paipan 项目可以用于这些应用中，提供准确的农历日期转换功能。

---

通过以上步骤，你可以快速上手 Paipan 项目，并将其应用到各种实际场景中。希望这个教程对你有所帮助！

paipan PHP JavaScript 农历公历干支历互转,万年历,四柱,六十甲子,属相,十二星座,二十四节气,支持从-1000到3000年间的八字排盘及大运推算,支持真太阳时,支持分析刑冲合害关系 项目地址: https://gitcode.com/gh_mirrors/pa/paipan