test/awtk
1
0
Fork 0
mirror of https://gitee.com/zlgopen/awtk.git synced 2024-11-30 02:58:26 +08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
d215ade8b5
awtk/docs/manual/date_time_t.md

214 lines
5.4 KiB
Markdown
Raw Normal View History

update docs
2018-12-20 17:33:31 +08:00
## date\_time\_t
### 概述
update docs
2019-11-15 11:33:43 +08:00
日期时间。
update docs
2019-11-14 17:55:31 +08:00
> 在嵌入式平台中，在系统初始时，需要调用date\_time\_global\_init设置实际获取/设置系统时间的函数。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-15 14:34:05 +08:00
----------------------------------
update docs
2018-12-20 17:33:31 +08:00
### 函数
<p id="date_time_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
update docs
2018-12-21 12:11:40 +08:00
| <a href="#date_time_t_date_time_create">date\_time\_create</a> | 创建date_time对象，并初始为当前日期和时间(一般供脚本语言中使用)。 |
| <a href="#date_time_t_date_time_destroy">date\_time\_destroy</a> | 销毁date_time对象(一般供脚本语言中使用)。 |
regenerate docs
2019-11-14 15:54:03 +08:00
| <a href="#date_time_t_date_time_global_init">date\_time\_global\_init</a> | 时间日期全局初始化。 |
update docs
2018-12-21 12:11:40 +08:00
| <a href="#date_time_t_date_time_init">date\_time\_init</a> | 初始为当前日期和时间。 |
regenerate docs
2019-11-14 15:54:03 +08:00
| <a href="#date_time_t_date_time_set">date\_time\_set</a> | 设置当前时间。 |
update docs
2018-12-20 17:33:31 +08:00
### 属性
<p id="date_time_t_properties">
fix docs
2019-01-17 15:56:15 +08:00
| 属性名称 | 类型 | 说明 |
update docs
2018-12-20 17:33:31 +08:00
| -------- | ----- | ------------ |
update docs
2018-12-21 18:29:29 +08:00
| <a href="#date_time_t_day">day</a> | int32\_t | 日(1-31)。 |
| <a href="#date_time_t_hour">hour</a> | int32\_t | 时(0 - 23)。 |
| <a href="#date_time_t_minute">minute</a> | int32\_t | 分(0 - 59)。 |
| <a href="#date_time_t_month">month</a> | int32\_t | 月(1-12)。 |
| <a href="#date_time_t_second">second</a> | int32\_t | 秒(0 - 59)。 |
update docs
2019-03-14 10:52:10 +08:00
| <a href="#date_time_t_wday">wday</a> | int32\_t | 星期几(0-6, Sunday = 0)。 |
update docs
2018-12-21 18:29:29 +08:00
| <a href="#date_time_t_year">year</a> | int32\_t | 年。 |
update docs
2018-12-20 17:33:31 +08:00
#### date\_time\_create 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_date_time_create">创建date_time对象，并初始为当前日期和时间(一般供脚本语言中使用)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-21 18:29:29 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
date_time_t* date_time_create ();
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | date\_time\_t* | 返回date\_time对象。 |
update docs
2019-01-14 11:38:31 +08:00
#### date\_time\_destroy 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_date_time_destroy">销毁date_time对象(一般供脚本语言中使用)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
update docs
2019-01-14 11:38:31 +08:00
ret_t date_time_destroy (date_time_t* dt);
update docs
2018-12-21 11:39:05 +08:00
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
update docs
2019-01-14 11:38:31 +08:00
| dt | date\_time\_t* | date\_time对象。 |
regenerate docs
2019-11-14 15:54:03 +08:00
#### date\_time\_global\_init 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_date_time_global_init">时间日期全局初始化。
> 嵌入式平台需要提供并设置获取当前日期和时间的函数，否则相关的功能(如时钟控件)将无法正常工作。
regenerate docs
2019-11-14 15:54:03 +08:00
* 函数原型：
```
ret_t date_time_global_init (date_time_get_now_t get, date_time_set_now_t set);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| get | date\_time\_get\_now\_t | 获取当前日期和时间的函数。 |
| set | date\_time\_set\_now\_t | 设置当前日期和时间的函数。 |
update docs
2019-01-14 11:38:31 +08:00
#### date\_time\_init 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_date_time_init">初始为当前日期和时间。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
update docs
2019-01-14 11:38:31 +08:00
date_time_t* date_time_init (date_time_t* dt);
update docs
2018-12-21 11:39:05 +08:00
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
update docs
2019-01-14 11:38:31 +08:00
| 返回值 | date\_time\_t* | 返回date\_time对象。 |
update docs
2018-12-20 17:33:31 +08:00
| dt | date\_time\_t* | date\_time对象。 |
regenerate docs
2019-11-14 15:54:03 +08:00
#### date\_time\_set 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_date_time_set">设置当前时间。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
regenerate docs
2019-11-14 15:54:03 +08:00
ret_t date_time_set (date_time_t* dt);
update docs
2018-12-21 11:39:05 +08:00
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
update docs
2019-01-14 11:38:31 +08:00
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
regenerate docs
2019-11-14 15:54:03 +08:00
| dt | date\_time\_t* | date\_time对象。 |
update docs
2018-12-20 17:33:31 +08:00
#### day 属性
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_day">日(1-31)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
improve digit clock
2019-03-11 17:57:27 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
| 可脚本化 | 是 |
update docs
2019-03-14 10:52:10 +08:00
#### hour 属性
improve digit clock
2019-03-11 17:57:27 +08:00
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_hour">时(0 - 23)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
improve digit clock
2019-03-11 17:57:27 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update docs
2019-01-14 11:38:31 +08:00
| 可脚本化 | 是 |
update docs
2019-03-14 10:52:10 +08:00
#### minute 属性
update docs
2018-12-20 17:33:31 +08:00
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_minute">分(0 - 59)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update docs
2019-01-14 11:38:31 +08:00
| 可脚本化 | 是 |
update docs
2019-03-14 10:52:10 +08:00
#### month 属性
update docs
2018-12-20 17:33:31 +08:00
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_month">月(1-12)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update docs
2019-01-14 11:38:31 +08:00
| 可脚本化 | 是 |
update docs
2019-03-14 10:52:10 +08:00
#### second 属性
update docs
2018-12-20 17:33:31 +08:00
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_second">秒(0 - 59)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update docs
2019-01-14 11:38:31 +08:00
| 可脚本化 | 是 |
update docs
2019-03-14 10:52:10 +08:00
#### wday 属性
update docs
2018-12-20 17:33:31 +08:00
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_wday">星期几(0-6, Sunday = 0)。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update docs
2019-01-14 11:38:31 +08:00
| 可脚本化 | 是 |
update docs
2018-12-20 17:33:31 +08:00
#### year 属性
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="date_time_t_year">年。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：int32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update docs
2019-01-14 11:38:31 +08:00
| 可脚本化 | 是 |
Reference in New Issue Copy Permalink