鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之TextClock组件

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

导入对象


  
  1. 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%')
  }
}
图例

你有时间常去我家看看我在这里谢谢你啦...

我家地址:亚丁号

最后送大家一首诗:

山高路远坑深,
大军纵横驰奔,

谁敢横刀立马?
惟有点赞加关注大军。

最近更新

  1. TCP协议是安全的吗?

    2024-02-03 04:30:02       18 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-02-03 04:30:02       19 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-02-03 04:30:02       19 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-02-03 04:30:02       20 阅读

热门阅读

  1. 大模型系列课程学习-prompt指令快速入门

    2024-02-03 04:30:02       34 阅读
  2. Sql Server之更改跟踪功能

    2024-02-03 04:30:02       33 阅读
  3. SQL Server 函数参考手册(SQL Server 日期函数)

    2024-02-03 04:30:02       34 阅读
  4. Node Exporter开启tcp相关指标

    2024-02-03 04:30:02       27 阅读
  5. chatchat部署在ubuntu上的坑

    2024-02-03 04:30:02       29 阅读
  6. Spring声明式事务

    2024-02-03 04:30:02       36 阅读
  7. 算法练习03——滑动窗口

    2024-02-03 04:30:02       39 阅读