时钟
时钟显示当前系统时间。它不需要 JS,放到卡片上后会按系统时间自动更新。
用法
在编辑器底部点加号,添加 时钟,然后在「格式」字段填显示格式:
| 格式 | 显示示例 |
|---|---|
HH:mm | 17:00 |
aa hh:mm | 上午 05:00 |
yyyy年M月d日 | 2026年6月5日 |
M月d日 EEEE | 6月5日 星期五 |
不填「格式」时跟随系统默认时间格式。卡片里常用 HH:mm。
属性
| 字段 | 可填写 | 说明 |
|---|---|---|
| 格式 | HH:mm / yyyy/M/d / M月d日 EEEE | 时间显示格式 |
| 时区偏移 | -8 / 5 | 东八区写 -8;留空跟随系统 |
| 字号 | 24 / 24vp / ${size} | 文字大小。填数字时按固定视觉尺寸显示,预览和桌面卡片更一致 |
| 字重 | normal / bold / medium | 按编辑器下拉选项填写 |
| 字体 | 编辑器下拉选项 | 使用指定字体 |
| 文字色 | #000000 / ${color} | 文字颜色 |
| 宽 / 高 | auto / 100 / 100% / ${w} | 时钟区域尺寸 |
| 水平偏移 / 垂直偏移 / Z 轴偏移 | 0 / 8 / ${x} | 只移动显示位置,不改变原本占位 |
| 内边距 / 外边距 | 8 / 8,8,8,8 | 四周留白 |
| 显示 | true / false / ${show} | 控制是否显示 |
| 背景色 | #FFFFFF / ${color} | 时钟背景 |
| 圆角 | 0 / 8 / 50% | 背景圆角 |
| 旋转角度 | 0 / 15 / ${angle} | 顺时针旋转角度 |
| 不透明度 | 0 到 1 | 1 为完全不透明 |
格式写法
常用字段:
| 写法 | 含义 | 示例 |
|---|---|---|
yyyy / yy | 年 | 2026 / 26 |
M / MM | 月 | 6 / 06 |
d / dd | 日 | 5 / 05 |
E / EEEE | 星期 | 周五 / 星期五 |
H / HH | 24 小时制 | 7 / 07 |
h / hh | 12 小时制 | 7 / 07 |
m / mm | 分钟 | 8 / 08 |
a | 上午 / 下午 | 上午 |
分隔符可以用 /、-、.、中文等:
yyyy/M/d
yyyy-MM-dd
yyyy年M月d日 EEEE
aa hh:mm
例:显示北京时间
「时区偏移」的正负号和常见 UTC+8 写法相反:东八区写 -8,西五区写 5。
| 字段 | 填写 |
|---|---|
| 格式 | HH:mm |
| 时区偏移 | -8 |
注意事项
卡片最小时间单位是分钟
鸿蒙卡片里的时钟最小时间单位为分钟。不要在卡片里依赖 ss、SS、SSS 做秒级或毫秒级显示。
不需要 JS 刷新
时钟自己跟随系统时间变化,不用在 JS 里写 setUpdateFreq。