更新记录
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 · 使用请保留作者署名或组件来源 🙌