更新记录

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 版本和浏览器版本,请勿提交业务密钥或客户资料。

隐私、权限声明

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

无系统权限要求。演示页可由用户主动复制已确认JSON,组件本身不读取剪贴板。

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

插件不采集任何数据;营业时间在用户端内存中处理,不发送网络请求、不自动存储。

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

无广告

暂无用户评论。