diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md
index 6f80bffcacf25c553d6d11f380a4195131ce3cb2..9c36c5f32c78b870089b7c97de46611da195d046 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md
@@ -21,7 +21,7 @@ TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | ---- | ------------------ | ------------------------------------------------------------ |
-| timeZoneOffset | number | 否 | 时区偏移量 | 设置时区偏移量。
取值范围为[-14:00, 12:00],表示东十二区到西十二区,其中负值表示东时区,正值表示西时区,比如东八区为-8:00。
对横跨国际日界线的国家或地区,用-13:00(UTC+13)和-14:00(UTC+14)来保证整个国家或者区域处在相同的时间。 |
+| timeZoneOffset | number | 否 | 当前系统的时区偏移量 | 设置时区偏移量。
取值范围为[-14, 12],表示东十二区到西十二区,其中负值表示东时区,正值表示西时区,比如东八区为-8。
对横跨国际日界线的国家或地区,用-13(UTC+13)和-14(UTC+14)来保证整个国家或者区域处在相同的时间,当设置的值不在取值范围内时,将使用当前系统的时区偏移量。 |
| contorller | [TextClockContorller](#textclockcontroller) | 否 | null | 绑定一个控制器,用来控制文本时钟的状态。|
## 属性
@@ -30,7 +30,7 @@ TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController
| 名称 | 参数类型 | 默认值 | 描述 |
| ------ | -------- | -------- | ------------------------------------------------------------ |
-| format | string | 'hhmmss' | 设置显示时间格式,如“yyyy/mm/dd”、“yyyy-mm-dd”等。
支持的时间格式化字符串:
- yyyy:年份。
- mm:英文月份简写。
- mmm:英文月份简写。
- mmmm:英文月份全称。
- dd:英文星期简写。
- ddd:英文星期简写。
- dddd:英文星期全称。
- HH:24小时制。
- hh:12小时制。
- MM/mm:分钟。
- SS/ss:秒。 |
+| format | string | 'hms' | 设置显示时间格式。
日期间隔符固定为"/",时间间隔符为":"。
如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:毫秒。|
## 事件
@@ -73,27 +73,27 @@ struct Second {
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('hhmmss')
- .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()
- })
- }
+ 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%')
}