disabledDate 函数是唯一可靠入口，仅2.9.8+支持且仅对date/datetime类型生效，需判空并返回true/false，禁用逻辑须统一在函数内处理，动态更新后必须调用reload()。
disabledDate 函数是唯一可靠入口
低版本 Layui（2.9.8 之前）根本不识别 disabledDate 配置项，写了也白执行。别指望用 CSS 类（如 laydate-disabled）手动加禁用样式——那只是视觉遮盖，用户仍能点、能回填、能绕过校验。
这个函数从 2.9.8 起正式支持，且只对 type: 'date' 和 type: 'datetime' 生效；time、year、month 类型下完全不触发。
- 每次渲染日历单元格时都会调用它，传入一个原生
Date实例（不是字符串或时间戳） - 你只需返回
true表示禁用当天，返回false或undefined表示可用 - 必须第一行判空：
if (!date) return false，否则初始化或清空时会报错中断
禁用指定日期（如节假日）怎么写才稳
最稳的方式是提前把不可选日期转成时间戳 Set，避免每次调用都做字符串解析或重复 new Date()：
const forbiddenDates = new Set([
new Date('2026-10-01').getTime(), // 国庆
new Date('2026-10-02').getTime(), // 国庆
new Date('2026-10-03').getTime(), // 国庆
new Date('2026-10-04').getTime(), // 国庆
new Date('2026-10-05').getTime(), // 国庆
new Date('2026-10-06').getTime(), // 国庆
new Date('2026-10-07').getTime(), // 国庆
new Date('2026-01-29').getTime(), // 春节
new Date('2026-01-30').getTime(), // 春节
new Date('2026-01-31').getTime(), // 春节
new Date('2026-02-01').getTime(), // 春节
new Date('2026-02-02').getTime(), // 春节
new Date('2026-02-03').getTime(), // 春节
new Date('2026-02-04').getTime(), // 春节
]);
laydate.render({
elem: '#date',
disabledDate: function(date) {
if (!date) return false;
return forbiddenDates.has(date.getTime());
}
});
- 别用
arr.includes(date.toISOString().split('T')[0])这类字符串匹配——时区偏移会让toISOString()生成的日期和用户本地显示不一致 - 如果日期来自后端 API，务必统一用时间戳或标准 ISO 格式（
YYYY-MM-DD）传输，前端再调.getTime() - 函数内避免同步查接口、遍历大数组、多次
new Date()——它执行频率极高，卡顿直接体现在日历展开延迟上
动态更新禁用列表后为什么没反应
改完 forbiddenDates 后，UI 日历不会自动重算。Laydate 不监听变量变化，必须显式触发重载：
- 拿到实例：
var ins = laydate.render({ elem: '#date' }) - 更新
forbiddenDates.add(new Date('2026-12-25').getTime()) - 立刻执行：
ins.reload()（Laydate ≥ 2.8.0 支持） - 老版本只能
ins.destroy()再laydate.render({...})，但会丢焦点和已填值
漏掉 reload() 是“明明改了却没反应”的最常见原因。
多个禁用条件共存时最容易漏的细节
比如既要禁节假日，又要禁周末，还要禁过去日期，所有逻辑必须塞进同一个 disabledDate 函数里，且顺序要合理：
disabledDate: function(date) {
if (!date) return false;
// 禁过去日期（含今天已过的每一分一秒）
if (date.getTime() < Date.now()) return true;
// 禁周末
const week = date.getDay();
if (week === 0 || week === 6) return true;
// 禁节假日
if (forbiddenDates.has(date.getTime())) return true;
// 所有条件都不满足 → 可用
return false;
}
- 千万别漏掉最后的
return false，否则没匹配上的日期也会被禁——这是最常被忽略的细节 - 别在函数里写
new Date().getDay()，那是当前时间的星期，不是date参数 - 国际化的周起始设置不影响
date.getDay()返回值（周日=0，周六=6），无需额外转换
复杂点在于：所有判断必须集中在一个函数里，且每次调用都要快；容易被忽略的是兜底 return false 和动态更新后的 reload() 调用。
