!21922 Update the format attribute of TextClock

Merge pull request !21922 from tengfan/RM021_TexeClockUpdateFormat0803

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md

@@ -25,9 +25,43 @@ TextClock(options?: { timeZoneOffset?: number, controller?: TextClockController
 
 除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性：
 
-| 名称   | 参数类型    | 描述                                                         |
-| ------ | --------------- | ------------------------------------------------------------ |
-| format | string    | 设置显示时间格式。<br/>日期间隔符固定为"/"，时间间隔符为":"。<br/>如yyyyMMdd，yyyy-MM-dd显示为yyyy/MM/dd，<br/>hhmmss显示为hh:mm:ss。 <br/>时间格式只用写一位即可，如"hhmmss"等同于"hms"。<br/>支持的时间格式化字符串：<br/>- YYYY/yyyy：完整年份。<br/>- YY/yy：年份后两位。<br/>- M：月份(若想使用01月则使用MM)。<br/>- d：日期(若想使用01日则使用dd)。<br/>- D：年中日(一年中的第几天)。<br/>- H：24小时制。<br/>- h：12小时制。<br/>- m：分钟。<br/>- s：秒。<br/>- SSS：毫秒。<br/>若格式未匹配，则使用默认值。<br/>默认值： 'hms'|
+| 名称   | 参数类型 | 描述                                                         |
+| ------ | -------- | ------------------------------------------------------------ |
+| format | string   | y：年<br />M：月<br />d：日<br />E：星期（星期默认应使用完整星期，例如：星期六；显示空间不足时才考虑使用简写星期，例如：周六）<br />H：小时（0~23）   h：小时（1~12）    <br/>m：分钟<br/>s：秒<br/>SS：厘秒<br />SSS：毫秒<br/>a：上午/下午（仅在12小时制中有效）<br />间隔符："年月日"、“/”、"-"、"."（开发者也可以自定义间隔符样式）<br />允许开发者自行拼接组合显示格式，即：年、月、日、星期、时、分、秒、毫秒可拆分为子元素，开发者可自行排布组合。<br /> |
+
+以下是format输入的格式样式及对应的显示效果：
+
+| 输入格式              | 显示效果 |
+| ------------------------------------------------------------ | ------ |
+| yyyy年M月d日 EEEE       | 2023年2月4日 星期六 |
+| yyyy年M月d日            | 2023年2月4日        |
+| M月d日 EEEE             | 2月4日 星期六       |
+| M月d日                  | 2月4日              |
+| MM/dd/yyyy              | 02/04/2023          |
+| EEEE MM月dd日           | 星期六 02月04日     |
+| yyyy（完整年份）        | 2023年              |
+| yy（年份后两位）        | 23年                |
+| MM（完整月份）          | 02月                |
+| M（月份）               | 2月 |
+| dd（完整日期） | 04日 |
+| d（日期） | 4日 |
+| EEEE（完整星期） | 星期六 |
+| E、EE、EEE（简写星期） | 周六 |
+| yyyy年M月d日 | 2023年2月4日 |
+| yyyy/M/d | 2023/2/4 |
+| yyyy-M-d | 2023-2-4 |
+| yyyy.M.d | 2023.2.4 |
+| HH:mm:ss（时:分:秒） | 17:00:04 |
+| aa hh:mm:ss（时:分:秒） | 上午 5:00:04 |
+| hh:mm:ss（时:分:秒） | 5:00:04 |
+| HH:mm（时:分） | 17:00 |
+| aa hh:mm（时:分） | 上午 5:00 |
+| hh:mm（时:分） | 5:00 |
+| mm:ss（分:秒） | 00:04 |
+| mm:ss.SS（分:秒:厘秒） | 00:04.91 |
+| mm:ss.SS（分:秒.毫秒） | 00:04.536 |
+| hh:mm:ss aa | 5:00:04 上午 |
+| HH | 17 |
 
 ## 事件
 
@@ -74,7 +108,7 @@ struct Second {
         .fontSize(20)
       // 以12小时制显示东八区的系统时间，精确到秒。
       TextClock({ timeZoneOffset: -8, controller: this.controller })
-        .format('hms')
+        .format('aa hh:mm:ss')
         .onDateChange((value: number) => {
           this.accumulateTime = value
         })