當(dāng)前系統(tǒng)時(shí)間

2024-01-22 17:30 更新

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

說明

該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

子組件

接口

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

參數(shù):

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

timeZoneOffset

number

設(shè)置時(shí)區(qū)偏移量。

取值范圍為[-14, 12],表示東十二區(qū)到西十二區(qū),其中負(fù)值表示東時(shí)區(qū),正值表示西時(shí)區(qū),比如東八區(qū)為-8。

對(duì)橫跨國際日界線的國家或地區(qū),用-13(UTC+13)和-14(UTC+14)來保證整個(gè)國家或者區(qū)域處在相同的時(shí)間,當(dāng)設(shè)置的值不在取值范圍內(nèi)時(shí),將使用當(dāng)前系統(tǒng)的時(shí)區(qū)偏移量。

默認(rèn)值:當(dāng)前系統(tǒng)的時(shí)區(qū)偏移量

controller

TextClockController

綁定一個(gè)控制器,用來控制文本時(shí)鐘的狀態(tài)。

屬性

除支持通用屬性外,還支持以下屬性:

名稱

參數(shù)類型

描述

format

string

設(shè)置顯示時(shí)間格式。

日期間隔符固定為"/",時(shí)間間隔符為":"。

如yyyyMMdd,yyyy-MM-dd顯示為yyyy/MM/dd,

hhmmss顯示為hh:mm:ss。

時(shí)間格式只用寫一位即可,如"hhmmss"等同于"hms"。

支持的時(shí)間格式化字符串:

- YYYY/yyyy:完整年份。

- YY/yy:年份后兩位。

- M:月份(若想使用01月則使用MM)。

- d:日期(若想使用01日則使用dd)。

- D:年中日(一年中的第幾天)。

- H:24小時(shí)制。

- h:12小時(shí)制。

- m:分鐘。

- s:秒。

- SSS:毫秒。

若格式未匹配,則使用默認(rèn)值。

默認(rèn)值: 'hms'

時(shí)間更新頻率最高為一秒一次,不建議單獨(dú)設(shè)置毫秒格式。

事件

除支持通用事件外,還支持以下事件:

名稱

功能描述

onDateChange(event: (value: number) => void)

提供時(shí)間變化回調(diào),該事件最小回調(diào)間隔為秒。

- value: Unix Time Stamp,即自1970年1月1日(UTC)起經(jīng)過的毫秒數(shù)。

TextClockController

TextClock容器組件的控制器,可以將該控制器綁定到TextClock組件,通過它控制文本時(shí)鐘的啟動(dòng)與停止。一個(gè)TextClock組件僅支持綁定一個(gè)控制器。

導(dǎo)入對(duì)象

  1. controller: TextClockController = new TextClockController();

start

start()

啟動(dòng)文本時(shí)鐘。

stop

stop()

停止文本時(shí)鐘。

示例

  1. @Entry
  2. @Component
  3. struct Second {
  4. @State accumulateTime: number = 0
  5. // 導(dǎo)入對(duì)象
  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小時(shí)制顯示東八區(qū)的系統(tǒng)時(shí)間,精確到秒。
  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. // 啟動(dòng)文本時(shí)鐘
  23. this.controller.start()
  24. })
  25. Button("stop TextClock")
  26. .onClick(() => {
  27. // 停止文本時(shí)鐘
  28. this.controller.stop()
  29. })
  30. }
  31. .width('100%')
  32. .height('100%')
  33. }
  34. }

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)