input[type="week"]用于声明性选择ISO周(格式YYYY-Wnn),非数字或日期;值为字符串,需手动转为日期范围,且存在浏览器兼容、解析、校验等多重陷阱。

input[type="week"] 不是用来“算周数”的,它是用来让用户**声明性选择某一年的第几周**——值永远是 YYYY-Wnn 格式字符串(如 "2026-W36"),不是数字,也不能直接当日期用。
为什么不能直接用 value 当日期或周序号
浏览器返回的 input.value 是字符串,不是 Date 对象,调用 .getDay() 或传给 new Date() 会得到 Invalid Date。常见错误包括:
- 写
const weekNum = parseInt(input.value)→ 得到NaN(因为"2026-W36"无法被parseInt正确解析) - 把
value直接发给后端做时间范围查询 → 后端没解析逻辑就报错 - 误以为
step="7"表示“按天步进” → 实际上step单位是“周”,step="7"是非法值,会被忽略
min/max 必须严格匹配 ISO 周格式
min 和 max 属性只接受 YYYY-Wnn 格式,填错就静默失效,控制台不报错,但约束形同虚设:
-
min="2026-09-01"❌ 浏览器完全忽略 -
min="2026-W36"✅ 合法(注意W大写、周号两位补零) -
max="2026-W53"要小心:2026 年实际只有 52 周,硬写W53会导致 Chrome 允许选择但提交校验失败 - 动态生成时必须用 JS 计算真实 ISO 周,不能靠年份硬推 —— 推荐用
Intl.DateTimeFormat或已验证的getISOWeek()函数
Firefox 不支持,降级方案不能只靠 CSS 隐藏
Firefox(截至 2026 年)仍把 type="week" 渲染为普通文本框,且不触发原生校验。这意味着:
立即学习“前端免费学习笔记(深入)”;
- 用户可手动输入任意字符串(如
"abc"、"2026-18"),checkValidity()仍可能返回true - 仅靠
:not([type="week"]) { display: none; }这类样式隐藏不可靠,需 JS 主动检测支持性 - 推荐做法:用
document.createElement('input').type = 'week'检测,不支持时插入两个type="date"(起止日)+ 自动计算周范围,或引入轻量库如flatpickr的周模式
拿到 YYYY-Wnn 后怎么转成周一至周日日期
没有浏览器内置方法能把 "2026-W36" 直接转成日期范围,必须手动转换。关键点是 ISO 周以周一为第一天,且第 1 周必须包含当年第 4 个星期四:
- 别用
new Date(year, 0, 1 + (week - 1) * 7)简单推算 —— 会跨年出错(比如 2026-W01 实际从 2025-12-29 开始) - 可靠做法:先算出该年第一个星期四,再反推第 1 周周一,最后偏移
(week - 1) * 7天得目标周一 - 示例函数核心逻辑:
function weekToDateRange(weekStr) { const [year, week] = weekStr.split('-W').map(Number); const jan1 = new Date(year, 0, 1); const daysToFirstThursday = (4 - jan1.getDay() + 7) % 7; const firstThursday = new Date(jan1); firstThursday.setDate(jan1.getDate() + daysToFirstThursday); const firstWeekStart = new Date(firstThursday); firstWeekStart.setDate(firstThursday.getDate() - 3); const targetMonday = new Date(firstWeekStart); targetMonday.setDate(firstWeekStart.getDate() + (week - 1) * 7); const targetSunday = new Date(targetMonday); targetSunday.setDate(targetMonday.getDate() + 6); return { monday: targetMonday.toISOString().split('T')[0], sunday: targetSunday.toISOString().split('T')[0] }; }
真正麻烦的从来不是选周,而是后续所有环节都得围绕这个字符串格式设计:校验、传输、存储、展示、范围计算。漏掉任意一环,就会在某个浏览器或某次表单提交里突然崩掉。



















