更新记录

1.0.0(2025-07-11)


平台兼容性

uni-app(4.06)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× - - - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - - - - - -

其他

多语言 暗黑模式 宽屏模式
× ×

📆 日历命理组件(yiwen-almanac)

基于 lunar-javascript 开发的日历命理信息展示组件,适用于 uni-app 小程序/APP/H5 项目,展示当日干支、吉凶、宜忌、值神等详细信息。


✅ 特性

  • ✅ 自动获取当前时间(或传入指定时间戳)
  • ✅ 展示包括十二时辰吉凶、建除十二神、吉神凶神、彭祖百忌、二十八星宿等
  • ✅ 支持五行颜色高亮
  • ✅ 适配微信小程序、APP、H5 平台

📦 使用方式

1. 导入组件

将组件文件放入项目目录,例如 components/yiwen-almanacyiwen-almanac/yiwen-almanac.vue,并在页面中引用:

<template>
  <view>
    <YiwenAlmanac :timestamp="timestamp" />
  </view>
</template>

<script setup>
import YiwenAlmanac from '@/components/yiwen-almanac/yiwen-almanac.vue'

// 可选:传入指定时间戳(单位:毫秒)
const timestamp = Date.now()
</script>

2. Props 参数

参数名 类型 是否必传 说明 默认值
timestamp Number 可选传入的时间戳(毫秒),用于指定展示日期 当前时间 new Date()

3. 效果截图

(请自行添加截图)


🧠 数据来源说明

本组件基于 lunar-javascript 获取农历与干支数据,核心调用包括:

  • Lunar.fromDate(new Date(timestamp)):构造农历数据
  • 获取内容包括:
    • 纳音、冲煞、值神
    • 十二时辰吉凶
    • 建除十二神、吉神凶神
    • 胎神、星宿、彭祖百忌、宜忌等

🎨 五行颜色说明

五行 颜色 说明
#008f05 深绿色
#f50000b8 红色偏深
#793c00 棕色
#ffc200 金黄色
#0386ed 天蓝色

🛠 注意事项

  • 如你传入的 timestamp 是字符串,请用 Number() 转换为数字
  • 默认展示当前系统时间对应的命理信息
  • 最小支持时间范围为公历 1900 年以后
  • 项目中请提前安装 lunar-javascript
npm install lunar-javascript@1.7.3

📄 License

MIT License · 使用请保留作者署名或组件来源 🙌

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问