data-*属性存储日期必须为字符串，读取后需手动new Date()并校验，不可依赖dataset自动转换；推荐ISO 8601格式，优先用getAttribute()获取原始值。
data-* 属性里存日期字符串，别转 Date 对象
data-* 属性只能存字符串，浏览器不会帮你把 data-created-at="2026-09-22" 自动解析成 Date 实例。你用 dataset.createdAt 拿到的永远是 "2026-09-22"，不是可调用 .getFullYear() 的对象。
常见错误现象：el.dataset.createdAt.getDate() 报错 TypeError: el.dataset.createdAt.getDate is not a function——因为它是字符串，不是 Date。
- 存日期推荐用 ISO 8601 格式（
"2026-09-22"或"2026-09-22T01:31:00"），语义清晰、可排序、易解析 - 避免用中文或本地化格式（如
"2026年9月22日"），后续new Date()可能解析失败 - 如果要存带时区的完整时间，用
toISOString()输出（"2026-09-22T01:31:00.000Z"），再存进data-timestamp
读取后必须手动 new Date()，且加校验
直接 new Date(el.dataset.timestamp) 看似简单，但遇到空值、非法格式会静默返回 Invalid Date，不报错也不提示。
常见错误现象：new Date(undefined) 返回 Invalid Date，后续 .getTime() 得到 NaN，导致计算逻辑崩掉。
立即学习“前端免费学习笔记（深入）”；
- 安全写法：先检查是否存在，再尝试构造
const ts = el.dataset.timestamp;<br>const date = ts && !isNaN(new Date(ts).getTime()) ? new Date(ts) : null;
- 如果日期字段必填，建议在 HTML 中确保有值，比如服务端渲染时补默认值：
data-timestamp="{{ now|date:'c' }}" - 不要依赖
dataset自动类型转换——它根本不会转，所有值都是字符串
用 getAttribute() 读比 dataset 更稳，尤其含数字或特殊字符时
如果你的日期属性名是 data-2024-start-date 或 data-updated-at-v2，dataset["2024StartDate"] 虽然能访问，但点号语法完全失效，且容易拼错键名。
更稳妥的做法是统一用 getAttribute()，它不依赖驼峰规则，不静默失败，返回原始字符串，便于后续 new Date() 处理。
-
el.getAttribute('data-updated-at')比el.dataset.updatedAt更可靠，尤其在 SSR 输出不规范时 - 服务端模板里写了
data-created="2026-09-22"，但 JS 里误写成dataset.created？没问题；要是写了data-Created或data_created，dataset就彻底返回undefined，而getAttribute('data-Created')至少还能拿到值 - 批量读多个日期字段时，用
Object.keys(el.dataset).filter(k => k.includes('date') || k.includes('time'))不靠谱——命名不规范的字段压根不会出现在dataset里
别把 data-* 当状态缓存，日期过期就得重载
data-* 存的是静态元数据，不是运行时状态。页面加载后你改了 el.dataset.expiresAt = "2026-12-31"，这个修改不会写回 HTML，刷新就丢；CSS 选择器如 [data-expires-at] 也不会重新匹配。
真正需要动态更新日期逻辑（比如倒计时、过期标记）时，得配合其他机制：
- 首次读取用
getAttribute('data-expires-at')初始化，之后用 JS 定时器或 MutationObserver 响应变化 - 想让 CSS 根据是否过期切换样式？不能只靠
data-expires-at，得手动el.setAttribute('data-is-expired', 'true')并配[data-is-expired="true"]选择器 - 用户离开再回来，日期可能已过期——
data-里的值不会自动刷新，得走 localStorage 或重新请求 API
日期字符串本身没坑，坑全在“以为它会自动变 Date”和“以为 dataset 能兜住所有命名”。只要记住：存是字符串，读是字符串，转 Date 是你自己的事，且必须校验。
