TextClock

TextClock組件通過文本將當前系統(tǒng)時間顯示在設(shè)備上。支持不同時區(qū)的時間顯示，最高精度到秒級。

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

子組件

無

接口

TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController })

參數(shù)：

屬性

除支持[通用屬性]外，還支持以下屬性：

以下是format輸入的格式樣式及對應的顯示效果：

事件

除支持[通用事件]外，還支持以下事件：

TextClockController

TextClock容器組件的控制器，可以將該控制器綁定到TextClock組件，通過它控制文本時鐘的啟動與停止。一個TextClock組件僅支持綁定一個控制器。

導入對象

controller: TextClockController = new TextClockController();

start

start()

啟動文本時鐘。

stop

stop()

停止文本時鐘。HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿

示例

@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小時制顯示東八區(qū)的系統(tǒng)時間，精確到秒。
      TextClock({ timeZoneOffset: -8, controller: this.controller })
        .format('aa hh:mm:ss')
        .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%')
  }
}

審核編輯 黃宇