W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
TextClock組件通過文本將當前系統(tǒng)時間顯示在設(shè)備上。支持不同時區(qū)的時間顯示,最高精度到秒級。
該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標單獨標記該內(nèi)容的起始版本。
TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController })
參數(shù):
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
timeZoneOffset | number | 否 | 設(shè)置時區(qū)偏移量。 取值范圍為[-14, 12],表示東十二區(qū)到西十二區(qū),其中負值表示東時區(qū),正值表示西時區(qū),比如東八區(qū)為-8。 對橫跨國際日界線的國家或地區(qū),用-13(UTC+13)和-14(UTC+14)來保證整個國家或者區(qū)域處在相同的時間,當設(shè)置的值不在取值范圍內(nèi)時,將使用當前系統(tǒng)的時區(qū)偏移量。 默認值:當前系統(tǒng)的時區(qū)偏移量 |
controller | 否 | 綁定一個控制器,用來控制文本時鐘的狀態(tài)。 |
除支持通用屬性外,還支持以下屬性:
名稱 | 參數(shù)類型 | 描述 |
---|---|---|
format | string | 設(shè)置顯示時間格式。 日期間隔符固定為"/",時間間隔符為":"。 如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' 時間更新頻率最高為一秒一次,不建議單獨設(shè)置毫秒格式。 |
除支持通用事件外,還支持以下事件:
名稱 | 功能描述 |
---|---|
onDateChange(event: (value: number) => void) | 提供時間變化回調(diào),該事件最小回調(diào)間隔為秒。 - value: Unix Time Stamp,即自1970年1月1日(UTC)起經(jīng)過的毫秒數(shù)。 |
- @Entry
- @Component
- struct Second {
- @State accumulateTime: number = 0
- // 導(dǎo)入對象
- 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('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%')
- }
- }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: