date_time_t

概述

日期时间。

在嵌入式平台中,在系统初始时,需要调用date_time_set_impl设置实际获取系统时间的函数。


函数

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

属性

属性名称 类型 说明
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)。
wday int32_t 星期几(0-6, Sunday = 0)。
year int32_t 年。

date_time_create 函数


  • 函数功能:

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

  • 函数原型:
  1. date_time_t* date_time_create ();
  • 参数说明:
参数 类型 说明
返回值 date_time_t* 返回date_time对象。

date_time_destroy 函数


  • 函数功能:

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

  • 函数原型:
  1. ret_t date_time_destroy (date_time_t* dt);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
dt date_time_t* date_time对象。

date_time_init 函数


  • 函数功能:

初始为当前日期和时间。

  • 函数原型:
  1. date_time_t* date_time_init (date_time_t* dt);
  • 参数说明:
参数 类型 说明
返回值 date_time_t* 返回date_time对象。
dt date_time_t* date_time对象。

date_time_set_impl 函数


  • 函数功能:

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

嵌入式平台需要提供并设置获取当前日期和时间的函数,否则相关的功能(如时钟控件)将无法正常工作。

  • 函数原型:
  1. ret_t 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 获取当前日期和时间的函数。

day 属性


日(1-31)。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化

hour 属性


时(0 - 23)。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化

minute 属性


分(0 - 59)。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化

month 属性


月(1-12)。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化

second 属性


秒(0 - 59)。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化

wday 属性


星期几(0-6, Sunday = 0)。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化

year 属性


年。

  • 类型:int32_t
特性 是否支持
可直接读取
可直接修改
可脚本化