Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
a87c3668
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
a87c3668
编写于
5月 25, 2022
作者:
L
LiAn
提交者:
Gitee
5月 25, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md.
Signed-off-by:
N
LiAn
<
lian15@huawei.com
>
上级
c7e15cf7
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
20 addition
and
15 deletion
+20
-15
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md
...n-dev/reference/arkui-ts/ts-basic-components-textclock.md
+20
-15
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md
浏览文件 @
a87c3668
# TextClock
> ![](public_sys-resources/icon-note.gif) **说明:** 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本
。
TextClock组件通过文本将当前系统时间显示在设备上。支持不同时区的时间显示,最高精度到秒级
。
TextClock通过文本显示当前系统时间,支持不同时区的时间显示,时间显示最高精度到秒级。
>**说明:**
>该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
...
...
@@ -14,36 +15,39 @@ TextClock通过文本显示当前系统时间,支持不同时区的时间显
## 接口
TextClock(options?: {
timeZoneOffset?: number, contorller?: TextClockController
})
TextClock(options?: {
timeZoneOffset?: number, controller?: TextClockController
})
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | ---- | ------------------ | ------------------------------------------------------------ |
| timeZoneOffset | number | 否 | 时区偏移量 | 设置时区偏移量。取值范围为[-14, 12],表示东十二区到西十二区,其中负值表示东时区,正值表示西时区,比如东八区为-8;对横跨国际日界线的国家或地区,用-13(UTC+13)和-14
(UTC+14)来保证整个国家或者区域处在相同的时间。 |
| contorller |
[
TextClockContorller
](
#TextClockC
ontroller
)
| 否 | null | 绑定一个控制器,用来控制文本时钟的状态。|
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | ---- | ------------------ | ------------------------------------------------------------ |
| timeZoneOffset | number | 否 | 时区偏移量 | 设置时区偏移量。
<br>
取值范围为[-14:00, 12:00],表示东十二区到西十二区,其中负值表示东时区,正值表示西时区,比如东八区为-8:00。
<br>
对横跨国际日界线的国家或地区,用-13:00(UTC+13)和-14:00
(UTC+14)来保证整个国家或者区域处在相同的时间。 |
| contorller |
[
TextClockContorller
](
#textclockc
ontroller
)
| 否 | null | 绑定一个控制器,用来控制文本时钟的状态。|
## 属性
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
| 名称 | 参数类型 | 默认值 | 描述 |
| ------ | -------- | -------- | ------------------------------------------------------------ |
| format | string | 'hhmmss' | 设置显示时间格式,如“yyyy/mm/dd”、“yyyy-mm-dd”等。
支持的时间格式化字符串:
<ul><li>
yyyy(年份)
</li><li>
mm(英文月份简写)
</li><li>
mmm(英文月份简写)
</li><li>
mmmm(英文月份全称)
</li><li>
dd(英文星期简写)
</li><li>
ddd(英文星期简写)
</li><li>
dddd(英文星期全称)
</li><li>
HH(24小时制)
</li><li>
hh(12小时制)
</li><li>
MM/mm(分钟)
</li><li>
SS/ss(秒)
</li></ul>
|
| format | string | 'hhmmss' | 设置显示时间格式,如“yyyy/mm/dd”、“yyyy-mm-dd”等。
<br>
支持的时间格式化字符串:
<br>
- yyyy:年份。
<br/>
- mm:英文月份简写。(需要对比差异)
<br/>
- mmm:英文月份简写。
<br/>
- mmmm:英文月份全称。
<br/>
- dd:英文星期简写。
<br/>
- ddd:英文星期简写。
<br/>
- dddd:英文星期全称。
<br/>
- HH:24小时制。
<br/>
- hh:12小时制。
<br/>
- MM/mm:分钟。
<br/>
- SS/ss:秒。
|
## 事件
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还支持以下事件:
| 名称 | 功能描述 |
| -------------------------------------------- | ------------------------------------------------------------ |
| onDateChange(event: (value: number) => void) | 提供时间变化回调
,该事件最小回调间隔为秒。
<br
/>
value: Unix Time Stamp,即自1970年1月1日(UTC)起经过的毫秒数。 |
| onDateChange(event: (value: number) => void) | 提供时间变化回调
,该事件最小回调间隔为秒。
<br
/>
-
value: Unix Time Stamp,即自1970年1月1日(UTC)起经过的毫秒数。 |
## TextClockController
TextClock容器组件的控制器,可以将此对象绑定
至TextClock组件,然后通过它控制文本时钟状态
的启动与停止。
TextClock容器组件的控制器,可以将此对象绑定
到TextClock组件,再通过它控制文本时钟
的启动与停止。
### 导入对象
```
```
ts
controller
:
TextClockController
=
new
TextClockController
()
```
### start
...
...
@@ -61,7 +65,7 @@ stop()
## 示例
```
```
ts
@
Entry
@
Component
struct
Second
{
...
...
@@ -70,8 +74,9 @@ struct Second {
build
()
{
Flex
({
direction
:
FlexDirection
.
Column
,
alignItems
:
ItemAlign
.
Center
,
justifyContent
:
FlexAlign
.
Center
})
{
Text('
current milliseconds is
' + this.accumulateTime)
Text
(
'
Current milliseconds is
'
+
this
.
accumulateTime
)
.
fontSize
(
20
)
// 以12小时制显示东八区的系统时间,精确到秒。
TextClock
({
timeZoneOffset
:
-
8
,
controller
:
this
.
controller
})
.
format
(
'
hhmmss
'
)
.
onDateChange
((
value
:
number
)
=>
{
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录