鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之TextClock组件
一、操作环境
操作系统: Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1+
二、TextClock组件
TextClock组件通过文本将当前系统时间显示在设备上。支持不同时区的时间显示，最高精度到秒级。
子组件
无。
接口
TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController })
构造参数
| 参数名 | 参数类型 | 必填 | 参数描述 |
|---|---|---|---|
| timeZoneOffset | number | 否 | 设置时区偏移量。 取值范围为[-14, 12]，表示东十二区到西十二区，其中负值表示东时区，正值表示西时区，比如东八区为-8。 对横跨国际日界线的国家或地区，用-13（UTC+13）和-14（UTC+14）来保证整个国家或者区域处在相同的时间，当设置的值不在取值范围内时，将使用当前系统的时区偏移量。 默认值：当前系统的时区偏移量 |
| controller | TextClockController | 否 | 绑定一个控制器，用来控制文本时钟的状态。 |
属性
除支持通用属性外，还支持以下属性：
| 名称 | 参数类型 | 描述 |
|---|---|---|
| format | string | 设置显示时间格式。 日期间隔符固定为"/"，时间间隔符为":"。 如yyyyMMdd，yyyy-MM-dd显示为yyyy/MM/dd， hhmmss显示为hh:mm:ss。 时间格式只用写一位即可，如"hhmmss"等同于"hms"。 支持的时间格式化字符串： - YYYY/yyyy：完整年份。 - YY/yy：年份后两位。 - M：月份(若想使用01月则使用MM)。 - d：日期(若想使用01日则使用dd)。 - D：年中日(一年中的第几天)。 - H：24小时制。 - h：12小时制。 - m：分钟。 - s：秒。 - SSS：毫秒。 若格式未匹配，则使用默认值。 默认值： 'hms' 时间更新频率最高为一秒一次，不建议单独设置毫秒格式。 |
事件
除支持通用事件外，还支持以下事件：
| 名称 | 功能描述 |
|---|---|
| onDateChange(event: (value: number) => void) | 提供时间变化回调，该事件最小回调间隔为秒。 - value: Unix Time Stamp，即自1970年1月1日（UTC）起经过的毫秒数。 |
TextClockController
TextClock容器组件的控制器，可以将该控制器绑定到TextClock组件，通过它控制文本时钟的启动与停止。一个TextClock组件仅支持绑定一个控制器。
导入对象
- controller: TextClockController = new TextClockController();
start
start()
启动文本时钟。
stop
stop()
停止文本时钟。
三、示例
代码
@Entry
@Component
struct Second {@State accumulateTime: number = 0// 导入对象controller: TextClockController = new TextClockController()build() {Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {Text('Current milliseconds is ' + this.accumulateTime).fontSize(20)// 以12小时制显示东八区的系统时间，精确到秒。TextClock({ timeZoneOffset: -8, controller: this.controller }).format('hms').onDateChange((value: number) => {this.accumulateTime = value}).margin(20).fontSize(30)Button("start TextClock").margin({ bottom: 10 }).onClick(() => {// 启动文本时钟this.controller.start()})Button("stop TextClock").onClick(() => {// 停止文本时钟this.controller.stop()})}.width('100%').height('100%')}
}图例
你有时间常去我家看看我在这里谢谢你啦...
我家地址:亚丁号
最后送大家一首诗:
山高路远坑深,
大军纵横驰奔,
谁敢横刀立马？
惟有点赞加关注大军。
