diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/textclock.png b/zh-cn/application-dev/reference/arkui-ts/figures/textclock.png new file mode 100644 index 0000000000000000000000000000000000000000..4b3151059514756afd6e91e7f829582a16e429d9 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/textclock.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md new file mode 100644 index 0000000000000000000000000000000000000000..a6173f048a929b12a1f612333995786ba2c962ad --- /dev/null +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md @@ -0,0 +1,136 @@ +# TextClock + +> **说明:** +>该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 + +TextClock主要用于显示系统时间,支持不同时区的时间显示,时间显示最高精度到秒级。 + +## 权限列表 + +无 + +## 子组件 + +无 + +## 接口 + +TextClock(options?: {hourswest?: number}) + +- 参数 + +
参数名 + |
+ 参数类型 + |
+ 必填 + |
+ 默认值 + |
+ 参数描述 + |
+
---|---|---|---|---|
hourwest + |
+ number + |
+ 否 + |
+ 系统时间所在的时区 + |
+ 设置时区信息,时区范围为[-14, 12],其中负值表示东时区,比如东八区为-8,浮点数也会进行相应的换算(30分钟/0.5时区);理论上时区范围是[-12,+12],但是一些国家横跨国际日界线,因此用-13(UTC+13)和-14(UTC+14)来保证整个国家或者区域处在相同的时间。 + |
+
名称 + |
+参数类型 + |
+默认值 + |
+描述 + |
+
---|---|---|---|
format + |
+string + |
+'hhmmss' + |
+设置显示时间格式,如“yyyy/mm/dd”、“yyyy-mm-dd”等。支持的时间格式化字符串:yyyy(年份),mm(英文月份简写),mmm(英文月份简写),mmmm(英文月份全称),dd(英文星期简写),ddd(英文星期简写),dddd(英文星期全称),HH(24小时制),hh(12小时制),MM/mm(分钟),SS/ss(秒)。 + |
+
status + |
+boolean + |
+- + |
+ 设置文本时钟的启动和停止。
|
+
名称 + |
+功能描述 + |
+|
---|---|---|
onDateChange(event: (value: number) => void) + |
+提供时间变化回调,回调参数为Unix Time Stamp,即自1970年1月1日(UTC)起经过的毫秒数,该事件最小回调间隔为秒。 + |
+