Clk_DateTimeMake()
Build a valid Clock epoch date/time structure.
Files
clk.h/clk.c
Prototype
| Code Block | ||
|---|---|---|
| ||
CPU_BOOLEAN Clk_DateTimeMake (CLK_DATE_TIME *p_date_time,
CLK_YR yr,
CLK_MONTH month,
CLK_DAY day,
CLK_HR hr,
CLK_MIN min,
CLK_SEC sec,
CLK_TZ_SEC tz_sec); |
Arguments
p_date_time
Pointer to variable that will receive the date/time structure.
...
Time zone offset (in seconds, ± from UTC) [-43200 to 43200].
Returned Values
DEF_OK
, if date/time structure successfully returned.
DEF_FAIL
, otherwise.
Required Configuration
None.
Notes / Warnings
Date/time structure (p_date_time) must be representable in Clock timestamp. Thus date to convert must be greater than or equal to CLK_EPOCH_YR_START and less than CLK_EPOCH_YR_END.
Example Usage
| Anchor | ||||
|---|---|---|---|---|
|
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
CLK_DATE_TIME date_time;
CPU_BOOLEAN valid;
/* 2010/09/18 11:11:11 UTC-05:00 */
valid = Clk_DateTimeMake(&date_time, 2010, 9, 18, 11, 11, 11, -18000);
if (valid == DEF_OK) {
printf("Date/time successfully created");
} else {
printf("Clock Date/time error\n\r");
} |