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

收藏人数:
购买普通授权版(
试用
使用 HBuilderX 导入示例项目
赞赏(2)
下载 17
赞赏 2
下载 12117877
赞赏 1826
赞赏
京公网安备:11010802035340号