Page Comparison

...

Anchor10556541055654 Clk_UnixDateTimeMake() Anchor10556551055655Build a valid Unix epoch date/time structure. Anchor10556561055656

Files

...

clk.h/clk.c

...

Prototype
 CLK_YR yr, CLK_MONTH month, CLK_DAY day, CLK_HR hr, CLK_MIN min, CLK_SEC sec, CLK_TZ_SEC tz_sec);
 HTML Tablecode
 Table Cell (td)
rowspan
5
 Anchor
1057219
1057219
classlanguage
Code_Listing
 Table Row (tr)
cpp
CPU_BOOLEAN  Clk_UnixDateTimeMake (CLK_DATE_TIME  *p_date_time,
 Anchor
1057220
1057220
 Anchor
1057221
1057221
 Anchor
1057222
1057222
 Anchor
1057223
1057223
 Anchor
1057224
1057224
 Anchor
1057225
1057225
 Anchor
1055660
1055660
 Table Row (tr)
 Table Row (tr)
 Table Row (tr)
 Table Row (tr)
...

                                   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.
anchoryr10701891070189 yr 
Year value 
[CLK_UNIX_EPOCH_YR_START to CLK_UNIX_EPOCH_YR_END).
 Anchor10690251069025month month 
Month value [CLK_MONTH_JAN to CLK_MONTH_DEC].
 Anchor10690261069026 day day
Day value [1 to 31].
anchorhr10690271069027 hr 
Hours value [0 to 23].
 Anchor10690281069028 min min
Minutes value [0 to 59].
 Anchor10690291069029sec sec 
Seconds value [0 to 60].
...
tz_sec
Time zone offset (in seconds, ± from UTC) [-43200 to 43200].
...
Returned Values
...
10572591057259DEF_OK, if date/time structure successfully returned. Anchor10556731055673
DEF_FAIL, otherwise. Anchor10556741055674
Required Configuration
 Anchor10617801061780Available only if CLK_CFG_UNIX_EN is DEF_ENABLED in clk_cfg.h (see section 3-1-1 Module Configuration). Anchor10556761055676
Notes / Warnings
...
Date/time structure (p_date_time) must be representable in Unix timestamp. Thus date to convert must be greater than or equal to CLK_UNIX_EPOCH_YR_START and less than CLK_UNIX_EPOCH_YR_END.
 Anchor10693721069372Day of week (p_date_time->DayOfWk) and Day of year (p_date_time->DayOfYr) are internally calculated and set in the date/time structure.
Example Usage
 Anchor
1055695
1055695
Listing - Clk_UnixDateTimeMake() Example Usage
...
class
Code_Listing
...
rowspan
8
...
Listing - Clk_UnixDateTimeMake() Example Usage

CPU_BOOLEAN
 valid;   /* 
    valid;
 
                                      /* 2010/09/18   11:11:11 UTC-05:00  */
 valid = 

valid = Clk_UnixDateTimeMake(&date_time, 2010, 9, 18, 11, 11, 11, -18000);
 if 

if (valid == DEF_OK)
 {
 {
    printf("Date/time successfully created");
 } else {

} else {
    printf("Clock Date/time error\n\r");
 }tr

}
 Code Block
language
cpp
title
Listing - Clk_UnixDateTimeMake() Example Usage
linenumbers
true
CLK_DATE_TIME  date_time;
 Anchor
1057321
1057321
 Anchor
1057322
1057322
 Anchor
1057323
1057323
 Anchor
1057324
1057324
 Anchor
1057325
1057325
 Anchor
1057326
1057326
 Anchor
1057327
1057327
 Anchor
1057328
1057328
 Anchor
1055680
1055680
 Table Row (tr)
 Table Row (tr)
 Table Row (tr)
 Table Row (tr)
 Table Row (tr)
 Table Row (tr)