time.h

Go to the documentation of this file.

 
 
#pragma once
 
#include <time.h>
#include "cx/cx.h"
 
CX_C_BEGIN
 
 
#define timeForever 9223372036854775807LL
 
#define timeS(s) timeFromSeconds(s)
 
#define timeMS(ms) timeFromMsec(ms)
 
 
 
enum WEEKDAYS {
    Sunday = 0,   
    Monday,       
    Tuesday,      
    Wednesday,    
    Thursday,     
    Friday,       
    Saturday      
};
 
extern strref timeDayName[];
 
extern strref timeDayAbbrev[];
 
extern strref timeMonthName[];
 
extern strref timeMonthAbbrev[];
 
typedef struct TimeParts {
    uint32 usec;    
    int32 year;     
    uint8 month;    
    uint8 day;      
    uint8 hour;     
    uint8 minute;   
    uint8 second;   
 
    // Information-only fields, not used for composition
    uint8 wday;    
    uint16 yday;   
} TimeParts;
 
bool timeDecompose(_Out_ TimeParts* out, _In_range_(0, timeForever) int64 time);
 
_Ret_range_(0, timeForever) int64 timeCompose(_In_ const TimeParts* parts);
 
_Success_(return > 0) int64 timeLocal(int64 time, _Out_opt_ int64* offset);
 
// end of time_manip group
 
 
_meta_inline int64 timeToSeconds(int64 time)
{
    return time / 1000000;
}
 
_meta_inline int64 timeFromSeconds(int64 seconds)
{
    return seconds * 1000000;
}
 
_meta_inline int64 timeToMsec(int64 time)
{
    return time / 1000;
}
 
_meta_inline int64 timeFromMsec(int64 msec)
{
    return msec * 1000;
}
 
_Ret_range_(0, timeForever) _meta_inline int64 timeFromRelTimespec(_In_ const struct timespec* ts)
{
    int64 ret = (int64)ts->tv_sec * 1000000;
    ret += ts->tv_nsec / 1000;
    return ret;
}
 
_meta_inline void timeToRelTimespec(_Out_ struct timespec* ts, int64 time)
{
    ts->tv_sec  = time / 1000000;
    ts->tv_nsec = (time % 1000000) * 1000;
}
 
_Ret_range_(0, timeForever) _meta_inline int64 timeFromAbsTimespec(_In_ const struct timespec* ts)
{
    int64 ret = (int64)ts->tv_sec * 1000000;
    ret += ts->tv_nsec / 1000;
 
    // Unix epoch is midnight on Jan 1, 1970
    // Which is a julian date of 2440587.50000
    // That's 210866760000 in seconds, or in microseconds...
 
    ret += 210866760000000000LL;   // adjust epoch
 
    // This still leaves us over 280,000 years before overflow
 
    return ret;
}
 
_meta_inline void timeToAbsTimespec(_Out_ struct timespec* ts, int64 time)
{
    time -= 210866760000000000LL;   // adjust epoch
 
    ts->tv_sec  = time / 1000000;
    ts->tv_nsec = (time % 1000000) * 1000;
}
 
_Ret_range_(0, timeForever) _meta_inline int64 timeFromTimeT(time_t tt)
{
    int64 ret = (int64)tt * 1000000;
    ret += 210866760000000000LL;   // adjust epoch
    return ret;
}
 
_meta_inline time_t timeToTimeT(int64 time)
{
    time -= 210866760000000000LL;   // adjust epoch
    return (time_t)(time / 1000000);
}
 
// end of time_convert group
 
CX_C_END