@duskmoon-dev/el-date时间
只显示的 Web 组件, 将 ISO 日期和日期时间格式化为语义 <time>
内容.
安装
bun add @duskmoon-dev/el-datetime
登记
import '@duskmoon-dev/el-datetime/register';
或明确登记:
import { register } from '@duskmoon-dev/el-datetime';
register();
使用量
<el-dm-datetime
value="2026-08-11T14:30:45Z"
format="YYYY-MM-DD HH:mm:ss"
time-zone="Asia/Shanghai"
></el-dm-datetime>
这个例子使得 2026-08-11 22:30:45 保留
内 <time datetime="..."> 属性.
属性
| 属性 | 类型 | 默认 | 说明 |
|---|---|---|---|
value | string | '' | 要显示的 ISO 日期或日期 |
format | string | 'YYYY-MM-DD HH:mm' | 输出格式 |
time-zone | string | '' | 印有时间戳的 IANA 时区 Z 或偏移; 空使用浏览器时区 |
格式符号
| 脚本 | 产出 |
|---|---|
YYYY, (中文(简体) ), YY | 四至二位数年份 |
M, (中文(简体) ), MM | 没有或零铺设的月份 |
D, (中文(简体) ), DD | 没有或零打字的一天 |
H, (中文(简体) ), HH | 24小时不打或零打板 |
h, (中文(简体) ), hh | 12小时时间没有或零铺设 |
m, (中文(简体) ), mm | 没有或没有零铺设的分钟 |
s, (中文(简体) ), ss | 没有或没有零打字的秒数 |
SSS | 毫秒数 |
A, (中文(简体) ), a | 大写或小写 |
括号内为正文,所以不解释符号字母:
<el-dm-datetime value="2026-08-11T14:30:45" format="YYYY-MM-DD [at] h:mm A"></el-dm-datetime>
这使得 2026-08-11 at 2:30 PM。 。 。 .
输入和时区行为
- 接受数值为
YYYY-MM-DD和ISO 等日期时间2026-08-11T14:30, (中文(简体) ),2026-08-11T14:30:45.123456Z,或2026-08-11T14:30:45+08:00分数 秒切为毫秒SSS符号 . - 仅日期和无偏移日期值为站点值,不由
time-zone。 。 。 . - 值为
Z页:1 改为:time-zone,或者当属性被省略时,浏览器的本地时区. - 无效的值、 不可能的日期和无效的时区使空内容没有 掷出.
使用明确的 Z 或当时间区转换重要时冲抵.
中央支助部分
| 编 | 说明 |
|---|---|
time | 语义 <time> 元素 |