当前系统时间

2024-01-22 17:30 更新

TextClock组件通过文本将当前系统时间显示在设备上。支持不同时区的时间显示,最高精度到秒级。

说明

该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

接口

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组件仅支持绑定一个控制器。

导入对象

  1. controller: TextClockController = new TextClockController();

start

start()

启动文本时钟。

stop

stop()

停止文本时钟。

示例

  1. @Entry
  2. @Component
  3. struct Second {
  4. @State accumulateTime: number = 0
  5. // 导入对象
  6. controller: TextClockController = new TextClockController()
  7. build() {
  8. Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
  9. Text('Current milliseconds is ' + this.accumulateTime)
  10. .fontSize(20)
  11. // 以12小时制显示东八区的系统时间,精确到秒。
  12. TextClock({ timeZoneOffset: -8, controller: this.controller })
  13. .format('hms')
  14. .onDateChange((value: number) => {
  15. this.accumulateTime = value
  16. })
  17. .margin(20)
  18. .fontSize(30)
  19. Button("start TextClock")
  20. .margin({ bottom: 10 })
  21. .onClick(() => {
  22. // 启动文本时钟
  23. this.controller.start()
  24. })
  25. Button("stop TextClock")
  26. .onClick(() => {
  27. // 停止文本时钟
  28. this.controller.stop()
  29. })
  30. }
  31. .width('100%')
  32. .height('100%')
  33. }
  34. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号