core/timestamp.h

Go to the documentation of this file.

#ifndef _TIMESTAMP_H
#define _TIMESTAMP_H

#include "platform.h"
#include <time.h>

#define NORMALRES /* use this to control default timestamp resolution */

#ifdef VERYHIGHRES
#define TS_SCALE (-9) /* system timescale is 1 nanosecond (1e-9 s)*/
#define TS_SECOND ((int64)1000000000) /* duration of one second */
#define TS_RESOLUTION (1e-9) /* must match scale */
#elif defined HIGHRES
#define TS_SCALE (-6) /* system timescale is 1 nanosecond (1e-9 s)*/
#define TS_SECOND ((int64)1000000) /* duration of one second */
#define TS_RESOLUTION (1e-6) /* must match scale */
#elif defined MEDIUMRES
#define TS_SCALE (-3) /* system timescale is 1 nanosecond (1e-9 s)*/
#define TS_SECOND ((int64)1000) /* duration of one second */
#define TS_RESOLUTION (1e-3) /* must match scale */
#else /* NORMALRES */
#define TS_SCALE (0) /* system timescale is 1 second (1e-0 s)*/
#define TS_SECOND ((int64)1) /* duration of one second */
#define TS_RESOLUTION (1) /* must be 10^TS_SCALE */
#endif

typedef int64 TIMESTAMP;

#define TS_ZERO ((int64)0)
#define TS_MAX (32482080000LL) /* roughly 3000 CE, any date beyond this should be interpreted as TS_NEVER */
#define TS_INVALID ((int64)-1)
#define TS_NEVER ((int64)(((unsigned int64)-1)>>1))
#define MINYEAR 1970
#define MAXYEAR 2969
#define ISLEAPYEAR(Y) ((Y)%4==0 && ((Y)%100!=0 || (Y)%400==0))

typedef struct s_datetime {
    unsigned short year; 
    unsigned short month; 
    unsigned short day; 
    unsigned short hour; 
    unsigned short minute; 
    unsigned short second; 
    unsigned int microsecond; 
    unsigned short is_dst; 
    char tz[5]; 
    unsigned short weekday; 
    unsigned short yearday; 
    TIMESTAMP timestamp; 
} DATETIME; 
#ifdef __cplusplus
extern "C" {
#endif

/* basic date and time functions */
char *timestamp_current_timezone(void);
TIMESTAMP mkdatetime(DATETIME *dt);
int strdatetime(DATETIME *t, char *buffer, int size);
int convert_from_timestamp(TIMESTAMP t, char *buffer, int size);
double timestamp_to_days(TIMESTAMP t);
double timestamp_to_hours(TIMESTAMP t);
double timestamp_to_minutes(TIMESTAMP t);
double timestamp_to_seconds(TIMESTAMP t);
TIMESTAMP convert_to_timestamp(char *value);
int local_datetime(TIMESTAMP ts, DATETIME *dt);

int timestamp_test(void);

char *timestamp_set_tz(char *tzname);
TIMESTAMP timestamp_from_local(time_t t);
time_t timestamp_to_local(TIMESTAMP t);

int local_tzoffset(TIMESTAMP t);

#ifdef __cplusplus
}
#endif

#endif

---

GridLAB-D^TM Version 2.0

An open-source project initiated by the US Department of Energy