提交 ee500c49 编写于 作者: E ester.zhou

update ts-basic-components-textclock.md (7851)

Signed-off-by: Nester.zhou <ester.zhou@huawei.com>
上级 81fc9a28
...@@ -2,8 +2,9 @@ ...@@ -2,8 +2,9 @@
The **<TextClock\>** component displays the current system time in text format for different time zones. The time is accurate to seconds. The **<TextClock\>** component displays the current system time in text format for different time zones. The time is accurate to seconds.
> **NOTE**<br> >**NOTE**
> This component is supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version. >
>This component is supported since API version 8. Updates will be marked with a superscript to indicate their earliest API version.
## Required Permissions ## Required Permissions
...@@ -17,12 +18,12 @@ Not supported ...@@ -17,12 +18,12 @@ Not supported
TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController }) TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController })
- Parameters **Parameters**
| Name | Type | Mandatory | Default Value | Description | | Name | Type| Mandatory| Default Value | Description |
| -------- | -------- | ---- | ------------------ | ------------------------------------------------------------ | | -------- | -------- | ---- | ------------------ | ------------------------------------------------------------ |
| timeZoneOffset | number | No | Time zone offset| Sets the time zone offset. The value range is [-14, 12], indicating UTC+12 to UTC-12. A negative value indicates Eastern Standard Time, and a positive value indicates Western Standard Time. For example, **-8** indicates UTC+8. For countries or regions crossing the International Date Line, use -13 (UTC+13) and -14 (UTC+14) to ensure consistent time within the entire country or region. | | timeZoneOffset | number | No | Time zone offset of the current system| Time zone offset.<br>The value range is [-14, 12], indicating UTC+12 to UTC-12. A negative value indicates Eastern Standard Time, and a positive value indicates Western Standard Time. For example, **-8** indicates UTC+8.<br>For countries or regions crossing the International Date Line, use -13 (UTC+13) and -14 (UTC+14) to ensure consistent time within the entire country or region. If the set value is not within the valid range, the time zone offset of the current system will be used.|
| contorller | [TextClockContorller](#textclockcontroller) | No| null | Binds a controller to control the status of the **<TextClock\>** component. | | contorller | [TextClockContorller](#textclockcontroller) | No| null | Binds a controller to control the status of the **<TextClock\>** component.|
## Attributes ## Attributes
...@@ -30,25 +31,24 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the ...@@ -30,25 +31,24 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
| Name | Type| Default Value | Description | | Name | Type| Default Value | Description |
| ------ | -------- | -------- | ------------------------------------------------------------ | | ------ | -------- | -------- | ------------------------------------------------------------ |
| format | string | 'hhmmss' | Time format, for example, **yyyy/mm/dd** or **yyyy-mm-dd**. Supported time format strings: <ul><li>yyyy (year)</li> <li>mm (two-letter abbreviated month name)</li> <li>mmm (three-letter abbreviated month name)</li> <li>mmmm (full month name)</li> <li>dd (two-letter abbreviated day of the week)</li> <li>ddd (three-letter abbreviated day of the week)</li> <li>dddd (full day of the week)</li> <li>HH (24-hour format)</li> <li>hh (12-hour format)</li> <li>MM/mm (minute)</li> <li>SS/ss (second)</li></ul>| | format | string | 'hms' | Time format.<br>The date separator is a slash (/), and the time separator is a colon (:).<br>For example, yyyyMMdd and yyyy-MM-dd are displayed as yyyy/MM/dd,<br>and hhmmss is displayed as hh:mm:ss.<br>Only one digit is required for the time format. This means that hhmmss is equivalent to hms.<br>Supported time format strings:<br>- YYYY/yyyy: four-digit year<br>- YY/yy: last two digits of year<br>- M: one-digit month (MM for two-digit month, for example, 01)<br>- d: one-digit day (dd for two-digit day, for example, 01)<br>- D: number of days that have elapsed in the year<br>- H: 24-hour format<br>- h: 12-hour format<br>- m: minute<br>- s: second<br>- SSS: millisecond|
## Events ## Events
In addition to the [universal events](ts-universal-events-click.md), the following attributes are supported. In addition to the universal events (ts-universal-events-click.md), the following events are supported.
| Name | Description | | Name | Description |
| -------------------------------------------- | ------------------------------------------------------------ | | -------------------------------------------- | ------------------------------------------------------------ |
| onDateChange(event: (value: number) => void) | Triggered when the time changes in seconds at minimum.<br> **value**: Unix time stamp, which is the number of milliseconds that have elapsed since the Unix epoch. | | onDateChange(event: (value: number) => void) | Called when the time changes in seconds at minimum.<br>**value**: Unix time stamp, which is the number of milliseconds that have elapsed since the Unix epoch. |
## TextClockController ## TextClockController
Controller of the **<TextClock\>** component, which can be bound to the component for status control. Implements a controller of the **<TextClock\>** component, which can be bound to the component for status control.
### Objects to Import ### Objects to Import
```ts ```ts
controller: TextClockController = new TextClockController() controller: TextClockController = new TextClockController()
``` ```
### start ### start
...@@ -74,27 +74,27 @@ struct Second { ...@@ -74,27 +74,27 @@ struct Second {
controller: TextClockController = new TextClockController() controller: TextClockController = new TextClockController()
build() { build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center}) { Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Text('Current milliseconds is ' + this.accumulateTime) Text('Current milliseconds is ' + this.accumulateTime)
.fontSize(20) .fontSize(20)
// Display the system time in 12-hour format for the UTC+8 time zone, accurate to seconds. // Display the system time in 12-hour format for the UTC+8 time zone, accurate to seconds.
TextClock({timeZoneOffset: -8, controller: this.controller}) TextClock({ timeZoneOffset: -8, controller: this.controller })
.format('hhmmss') .format('hms')
.onDateChange((value: number) => { .onDateChange((value: number) => {
this.accumulateTime = value this.accumulateTime = value
}) })
.margin(20) .margin(20)
.fontSize(30) .fontSize(30)
Button("start TextClock") Button("start TextClock")
.margin({ bottom: 10 }) .margin({ bottom: 10 })
.onClick(()=>{ .onClick(() => {
this.controller.start() this.controller.start()
}) })
Button("stop TextClock") Button("stop TextClock")
.onClick(()=>{ .onClick(() => {
this.controller.stop() this.controller.stop()
}) })
} }
.width('100%') .width('100%')
.height('100%') .height('100%')
} }
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册