0068611b4d
Now we manage a timezone and daylight-savings aware version of localtime. We parse UNIX timezone strings. The default (active after the first call to localtime or localtime_r) is CET/CEST, the timezone of Europe/Vienna. The wallclock-time osd-example demonstrates how to set a different timezone via the timezone resource. Note: After startup no timezone is set. So in this state querying the timezone resource will return an empty string. After first call to localtime (if not timezone has been set via the timezone resource) a query to timezone will return the default timezone string for CET/CEST. The string returned by the localtime and utc timezones now also includes the timezone name. New fields tm_gmtoff and tm_zone were added to the tm structure. These are available in BSD systems and when setting special compiler definitions on Linux. Note: the timezone offset information in the tm structure (tm_gmtoff) as well as in the tz structure returned by gettimeofday (tz_minuteswest) may be wrong sign, this code is largely untested.
97 lines
2.5 KiB
C
97 lines
2.5 KiB
C
/**
|
|
* \defgroup Time related functions
|
|
*
|
|
* This rolls the necessary definition for getting/setting time and
|
|
* managing local time into one include file, on posix systems this
|
|
* lives in at least two include files, time.h and sys/time.h
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* \file
|
|
* Definitions for the time module
|
|
*
|
|
* \author
|
|
* Ralf Schlatterbeck <rsc@tux.runtux.com>
|
|
*/
|
|
|
|
#ifndef time_h
|
|
#define time_h
|
|
|
|
#ifdef LOCAL_COMPILE
|
|
#define tm l_tm
|
|
#define timeval l_timeval
|
|
#define time_t l_time_t
|
|
#define gmtime l_gmtime
|
|
#define localtime l_localtime
|
|
#define gettimeofday l_gettimeofday
|
|
#define clock_seconds() 1
|
|
#define clock_time() 1
|
|
#endif
|
|
|
|
#define DEFAULT_TIMEZONE "CET-1CEST,M3.5.0,M10.5.0/3"
|
|
|
|
typedef signed long long time_t;
|
|
typedef signed long suseconds_t;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* tm_gmtoff and tm_zone are BSD additions */
|
|
struct tm {
|
|
uint32_t tm_year; /* year */
|
|
uint16_t tm_yday; /* day in the year */
|
|
uint8_t tm_sec; /* seconds */
|
|
uint8_t tm_min; /* minutes */
|
|
uint8_t tm_hour; /* hours */
|
|
uint8_t tm_mday; /* day of the month */
|
|
uint8_t tm_mon; /* month */
|
|
uint8_t tm_wday; /* day of the week */
|
|
uint8_t tm_isdst; /* daylight saving time */
|
|
int32_t tm_gmtoff; /* Seconds east of UTC */
|
|
const char *tm_zone; /* Timezone abbreviation */
|
|
};
|
|
|
|
struct timeval {
|
|
time_t tv_sec; /* seconds */
|
|
suseconds_t tv_usec; /* microseconds */
|
|
};
|
|
|
|
struct timezone {
|
|
int16_t tz_minuteswest; /* minutes west of Greenwich */
|
|
int tz_dsttime; /* type of DST correction, unused */
|
|
};
|
|
|
|
struct tm *gmtime (const time_t *timep);
|
|
struct tm *gmtime_r (const time_t *timep, struct tm *result);
|
|
struct tm *localtime (const time_t *timep);
|
|
struct tm *localtime_r (const time_t *timep, struct tm *result);
|
|
|
|
int gettimeofday (struct timeval *tv, struct timezone *tz);
|
|
int settimeofday (const struct timeval *tv, const struct timezone *tz);
|
|
|
|
/*
|
|
* Maximum length of all timezone names, this is much longer in UNIX
|
|
* implementations but we have limited space here. Note that the length
|
|
* includes a trailing \0 byte for each timezone name.
|
|
*/
|
|
#ifndef TZ_MAX_CHARS
|
|
#define TZ_MAX_CHARS 16
|
|
#endif
|
|
|
|
/* Maximum length of buffer to reserve for timezone string */
|
|
#define MAXTZLEN (TZ_MAX_CHARS+9+2*(2+6+1+8)+1)
|
|
|
|
int set_tz (const char *tzstring);
|
|
const char *get_tz (char *buffer, size_t buflen);
|
|
size_t len_tz (void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // time_h
|
|
/** @} */
|