awtk/docs/manual/date_time_t.md

date_time_t

概述

日期时间。

函数

函数名称	说明
date_time_create	创建date_time对象，并初始为当前日期和时间(一般供脚本语言中使用)。
date_time_date_time_set_impl	设置获取当前日期和时间的函数。
date_time_destroy	销毁date_time对象(一般供脚本语言中使用)。
date_time_init	初始为当前日期和时间。

属性

名属性称	类型	说明
day	int32_t	日(1-31)。
hour	int32_t	时(0 - 23)。
minute	int32_t	分(0 - 59)。
month	int32_t	月(1-12)。
second	int32_t	秒(0 - 59)。
year	int32_t	年。

事件

事件名称	类型	说明

date_time_create 函数

• 函数原型：

date_time_t* date_time_create ();

• 参数说明：

---

参数	类型	说明
返回值	date_time_t*	返回date_time对象。

• 函数功能：

创建date_time对象，并初始为当前日期和时间(一般供脚本语言中使用)。

date_time_date_time_set_impl 函数

• 函数原型：

ret_t date_time_date_time_set_impl (date_time_get_now_t date_time_get_now);

• 参数说明：

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
date_time_get_now	date_time_get_now_t	获取当前日期和时间的函数。

• 函数功能：

设置获取当前日期和时间的函数。

date_time_destroy 函数

• 函数原型：

ret_t date_time_destroy (date_time_t* dt);

• 参数说明：

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
dt	date_time_t*	date_time对象。

• 函数功能：

销毁date_time对象(一般供脚本语言中使用)。

date_time_init 函数

• 函数原型：

date_time_t* date_time_init (date_time_t* dt);

• 参数说明：

---

参数	类型	说明
返回值	date_time_t*	返回date_time对象。
dt	date_time_t*	date_time对象。

• 函数功能：

初始为当前日期和时间。

day 属性

---

日(1-31)。

• 类型：int32_t

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	否
可脚本化	否
可在IDE中设置	否
可在XML中设置	否
支通过widget_get_prop读取	否
支通过widget_set_prop修改	否

hour 属性

---

时(0 - 23)。

• 类型：int32_t

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	否
可脚本化	否
可在IDE中设置	否
可在XML中设置	否
支通过widget_get_prop读取	否
支通过widget_set_prop修改	否

minute 属性

---

分(0 - 59)。

• 类型：int32_t

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	否
可脚本化	否
可在IDE中设置	否
可在XML中设置	否
支通过widget_get_prop读取	否
支通过widget_set_prop修改	否

month 属性

---

月(1-12)。

• 类型：int32_t

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	否
可脚本化	否
可在IDE中设置	否
可在XML中设置	否
支通过widget_get_prop读取	否
支通过widget_set_prop修改	否

second 属性

---

秒(0 - 59)。

• 类型：int32_t

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	否
可脚本化	否
可在IDE中设置	否
可在XML中设置	否
支通过widget_get_prop读取	否
支通过widget_set_prop修改	否

year 属性

---

年。

• 类型：int32_t

特性	是否支持
可直接读取	是
可直接修改	否
可持久化	否
可脚本化	否
可在IDE中设置	否
可在XML中设置	否
支通过widget_get_prop读取	否
支通过widget_set_prop修改	否