更新记录
1.0.0(2026-11-16)
- 首发每周营业时间编辑组件,支持七天开关、每日最多四段、全天和跨夜。
- 支持复制到工作日或全周,以及同天、跨天和周日循环的冲突校验。
- 提供原始草稿、校验结果和确认结果事件;附纯函数 API 和示例工程。
- 首版支持 uni-app x Web Chrome / Chromium,VDOM 模式。
平台兼容性
uni-app x(5.34.0)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | - | - | - | - | - |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | √ | × |
每周营业时间编辑器 tinybiz-weekhours
给门店后台增加一套可直接接入的每周营业时间表。适合餐饮午休分段、夜宵跨夜、工作日营业和周末休息等设置页面。
首版支持 uni-app x 的 Web(Chrome / Chromium),VDOM 模式。HBuilderX 5.34。 Android、iOS、鸿蒙、小程序、普通 uni-app、蒸汽模式及 Safari 均未验证,购买前请确认项目平台。本插件不包含预约下单、员工排班、库存、服务器、具体日期、节假日、时区或夏令时处理。
功能
- 一周 7 天独立开关,每天最多 4 段营业时间。
- 开始 / 结束时间按 HH:mm 输入;可明确选择“次日”,单段不超过 24 小时。
- 支持同天、多天及周日跨周一冲突校验,中文提示错误位置。
- 支持全天 00:00–24:00,将某一天的状态和时段复制到工作日或全周。
- 时间相接不算冲突,例如 09:00–12:00 和 12:00–18:00。
- 关闭营业日保留当前编辑草稿,确认结果会清空该日时段。前一天的跨夜部分仍然有效。
- 编辑草稿与确认结果分开,错误数据不能确认,支持只读模式。
- 无运行时第三方依赖、无网络请求、无广告、不自动存储。
快速接入
通过 HBuilderX 导入到 uni-app x 项目。组件遵循 easycom,无需手动注册。
<template>
<tinybiz-weekhours v-model="draft" @confirm="saveHours" />
</template>
<script setup lang="uts">
import { ref } from 'vue'
const draft = ref('')
function saveHours(value: string) {
// value 是经过校验的规范 JSON,可在这里交给自己的接口保存。
console.log(value)
}
</script>
初始空字符串会生成工作日 09:00–18:00、周末休息的默认表。已有配置直接赋给 draft。外部值更新会重建编辑表;非法 JSON 或字段类型错误会显示提示并禁止编辑、确认。修正外部值即可恢复。
属性与事件
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| modelValue / v-model | string | 空字符串 | 完整一周的 JSON 草稿 |
| disabled | boolean | false | 禁止编辑和确认 |
| title | string | 每周营业时间 | 标题 |
| 事件 | 参数 | 触发时机 |
|---|---|---|
| update:modelValue | string | 用户编辑时输出原始草稿,包括关闭日暂存的时段 |
| change | HoursCheck | 用户编辑后输出校验结果;不在初始化或外部赋值时触发 |
| confirm | string | 点击确认,且数据有效时输出规范 JSON;关闭日时段清空 |
v-model 草稿可能暂时无效。业务保存请使用 confirm,或主动调用 validateWeek 后检查 valid。组件不直接修改 props,不负责持久化。
数据结构与纯函数
type HourPeriod = { start: string, end: string, nextDay: boolean }
type DayHours = { day: number, open: boolean, periods: HourPeriod[] }
type HoursError = { day: number, period: number, code: string, message: string }
type HoursCheck = { valid: boolean, errors: HoursError[], value: string }
数组必须有七个唯一的 day,1=周一、7=周日,规范结果按星期排序。错误中的 period 从 0 开始,-1 表示整天或整体结构问题,day=0 表示整体错误。多余字段不会进入规范结果。
单日样例(保存时须放入完整七天数组):
{"day":1,"open":true,"periods":[{"start":"18:00","end":"02:00","nextDay":true}]}
import { defaultWeek, cloneWeek, parseWeek, validateWeek, summarizeWeek }
from '@/uni_modules/tinybiz-weekhours'
| 函数 | 行为 |
|---|---|
| defaultWeek() | 返回新的默认七天表 |
| cloneWeek(week) | 深拷贝结构合法的七天表 |
| parseWeek(json) | 检查字段结构并按星期排序;错误返回 null;只接受空字符串作为默认值 |
| validateWeek(week) | 检查结构、时间范围及冲突;有效时返回规范 JSON,无效时 value 为空字符串 |
| summarizeWeek(week) | 对已校验的数据生成逐日中文摘要 |
parseWeek 允许尚未编辑完成的时间字符串,结构正确不等于营业时间有效,最终必须经过 validateWeek。开始时间不接受 24:00;结束时间只在非次日时接受 24:00。非次日结束必须晚于开始;次日结束换算加 24 小时后,单段须大于 0 且不超过 24 小时。
复制会覆盖目标天的营业开关和全部时段。建议业务页面保留原配置,以便用户取消编辑。
演示与验证
示例工程提供工作日、午休分段、夜宵跨夜、周日冲突、只读和外部非法数据场景。用 HBuilderX 导入示例工程后运行到 Web 即可体验。确认结果可由用户主动复制。
纯逻辑已通过 26 项自动测试,包含 400 组固定种子随机营业表与独立逐分钟占用算法的对照验证。测试不代表未列出的平台兼容性。
隐私与许可
组件仅在内存中处理传入的营业时间,不发送请求、不采集个人信息、不主动读写存储、不申请系统权限。示例页复制按钮仅在用户点击时写入已确认的 JSON。
授权和使用范围按 DCloud 插件市场所购买的授权类型及平台协议执行。问题反馈请通过本插件市场页面的评论区提供复现步骤、HBuilderX 版本和浏览器版本,请勿提交业务密钥或客户资料。

收藏人数:
购买源码授权版(
试用
使用 HBuilderX 导入示例项目
赞赏(0)
下载 0
赞赏 0
下载 12768397
赞赏 1959
赞赏
京公网安备:11010802035340号