%% options copyright owner = Dirk Krause copyright year = 2015-xxxx license = bsd %% header /** @file Retrieve current timestamp (time as visible on the clock), compare timestamps, convert to text. */ #ifndef DK4CONF_H_INCLUDED #include "dk4conf.h" #endif #ifndef DK4TYPES_H_INCLUDED #include "dk4types.h" #endif #ifndef DK4ERROR_H_INCLUDED #include "dk4error.h" #endif #if DK4_ON_WINDOWS && (DK4_WIN_AVOID_CRT || DK4_WIN_DENY_CRT) #ifndef WINDOWS_H_INCLUDED #include #define WINDOWS_H_INCLUDED 1 #endif #else #if DK4_HAVE_SYS_TYPES_H #ifndef SYS_TYPES_H_INCLUDED #include #define SYS_TYPES_H_INCLUDED 1 #endif #endif #if DK4_TIME_WITH_SYS_TIME #ifndef SYS_TIME_H_INCLUDED #include #define SYS_TIME_H_INCLUDED 1 #endif #ifndef TIME_H_INCLUDED #include #define TIME_H_INCLUDED 1 #endif #else #if DK4_HAVE_TIME_H #ifndef TIME_H_INCLUDED #include #define TIME_H_INCLUDED 1 #endif #else #if DK4_HAVE_SYS_TIME_H #ifndef SYS_TIME_H_INCLUDED #include #define SYS_TIME_H_INCLUDED 1 #endif #endif #endif #endif #ifndef DK4TIME_H_INCLUDED #include "dk4time.h" #endif #endif #if DK4_ON_WINDOWS && (DK4_WIN_AVOID_CRT || DK4_WIN_DENY_CRT) /** Time as shown on the clock. */ typedef SYSTEMTIME dk4_clock_time_t; #else /** Time as shown on the clock. */ typedef dk4_time_t dk4_clock_time_t; #endif #ifdef __cplusplus extern "C" { #endif /** Retrieve current date and time. CRT on Windows: Optional. @param dptr Result buffer. @return 1 on success, 0 on error. */ int dk4clocktime_get(dk4_clock_time_t *dptr); /** Compare two timestamps. CRT on Windows: Optional. @param l Left timestamp. @param r Right timestamp. @return 1 if l>r, 0 if l=r, -1 if l if dptr is NULL or dsz is 0, - DK4_E_MATH_OVERFLOW
if a mathematical overflow occures in a size calculation, - DK4_E_BUFFER_TOO_SMALL
if the buffer is too small. */ int dk4clocktime_to_text( dkChar *dptr, size_t dsz, const dk4_clock_time_t *clt, dk4_er_t *erp ); #ifdef __cplusplus } #endif %% module #include "dk4conf.h" #include "dk4types.h" #include "dk4ctime.h" #ifndef DK4REC22_H_INCLUDED #include "dk4rec22.h" #endif #ifndef DK4TIME_H_INCLUDED #include "dk4time.h" #endif #ifndef DK4TIMEDK_H_INCLUDED #include "dk4timedk.h" #endif #ifndef DK4TIME08_H_INCLUDED #include "dk4time08.h" #endif int dk4clocktime_get(dk4_clock_time_t *dptr) { if (NULL != dptr) { #if DK4_ON_WINDOWS && (DK4_WIN_AVOID_CRT || DK4_WIN_DENY_CRT) GetLocalTime(dptr); return 1; #else dk4time_get(dptr); return 1; #endif } else { return 0; } } int dk4clocktime_compare(const dk4_clock_time_t *l, const dk4_clock_time_t *r) { int back = 0; if (NULL != l) { if (NULL != r) { #if DK4_ON_WINDOWS && (DK4_WIN_AVOID_CRT || DK4_WIN_DENY_CRT) if (l->wYear > r->wYear) { back = 1; } else { if (l->wYear < r->wYear) { back = -1; } } if (0 == back) { if (l->wMonth > r->wMonth) { back = 1; } else { if (l->wMonth < r->wMonth) { back = -1; } } } if (0 == back) { if (l->wDay > r->wDay) { back = 1; } else { if (l->wDay < r->wDay) { back = -1; } } } if (0 == back) { if (l->wHour > r->wHour) { back = 1; } else { if (l->wHour < r->wHour) { back = -1; } } } if (0 == back) { if (l->wMinute > r->wMinute) { back = 1; } else { if (l->wMinute < r->wMinute) { back = -1; } } } if (0 == back) { if (l->wSecond > r->wSecond) { back = 1; } else { if (l->wSecond < r->wSecond) { back = -1; } } } #else if (*l > *r) { back = 1; } else { if (*l < *r) { back = -1; } } #endif } else { back = 1; } } else { if (NULL != r) { back = -1; } } return back; } /** Convert timestamp to text ``yyyy-mm-dd hh:mm:ss''. @param dptr Result buffer address. @param dsz Result buffer size (number of dkChar). @param clt Timestamp to convert. @param erp Error report, may be NULL. @return 1 on success, 0 on error. */ int dk4clocktime_to_text( dkChar *dptr, size_t dsz, const dk4_clock_time_t *clt, dk4_er_t *erp ) { #if DK4_ON_WINDOWS && (DK4_WIN_AVOID_CRT || DK4_WIN_DENY_CRT) back = dk4time_to_text( dptr, dsz, DK4_TIMEFORMAT_DATE_TIME, clt->wYear, clt->wMonth, clt->wDay, clt->wHour, clt->wMinute, clt->wSecond, erp ); #else #if DK4_CHAR_SIZE > 1 char buf[32]; int back = 0; if (0 != dk4time_as_text_c8(buf, sizeof(buf), clt, erp)) { back = dk4recode_char_to_dk(dptr, dsz, buf, erp); } return back; #else return (dk4time_as_text(dptr, dsz, clt, erp)); #endif #endif }