glk_time_to_date_utc ()

void
glk_time_to_date_utc (glktimeval_t *time,
                      glkdate_t *date);

Convert the given timestamp (as returned by glk_current_time()) to a broken-out structure. This function returns a date and time in universal time (GMT).

glk_time_to_date_local ()

void
glk_time_to_date_local (glktimeval_t *time,
                        glkdate_t *date);

Does the same thing as glk_time_to_date_utc(), but this function returns local time.

glk_simple_time_to_date_utc ()

void
glk_simple_time_to_date_utc (glsi32 time,
                             glui32 factor,
                             glkdate_t *date);

Convert the given timestamp (as returned by glk_current_simple_time()) to a broken-out structure in universal time. The time argument is multiplied by factor to produce a Unix timestamp.

Since the resolution of glk_simple_time_to_date_utc() and glk_simple_time_to_date_local() is no better than seconds, they will return zero for the microseconds value.

glk_simple_time_to_date_local ()

void
glk_simple_time_to_date_local (glsi32 time,
                               glui32 factor,
                               glkdate_t *date);

Does the same thing as glk_simple_time_to_date_utc(), but fills in the date structure in local time.

glk_date_to_time_utc ()

void
glk_date_to_time_utc (glkdate_t *date,
                      glktimeval_t *time);

Convert the broken-out structure (interpreted as universal time) to a timestamp. The weekday value in date is ignored. The other values need not be in their normal ranges; they will be normalized.

If the time cannot be represented by the platform's time library, this may return -1 for the seconds value. (I.e., the high_sec and low_sec fields both $FFFFFFFF. The microseconds field is undefined in this case.)

glk_date_to_time_local ()

void
glk_date_to_time_local (glkdate_t *date,
                        glktimeval_t *time);

Does the same thing as glk_date_to_time_utc(), but interprets the broken-out structure as local time.

The glk_date_to_time_local() function may not be smart about Daylight Saving Time conversions.

glk_date_to_simple_time_utc ()

glsi32
glk_date_to_simple_time_utc (glkdate_t *date,
                             glui32 factor);

Convert the broken-out structure (interpreted as universal time) to a timestamp divided by factor . The weekday value in date is ignored. The other values need not be in their normal ranges; they will be normalized.

If the time cannot be represented by the platform's time library, this may return -1.

glk_date_to_simple_time_local ()

glsi32
glk_date_to_simple_time_local (glkdate_t *date,
                               glui32 factor);

Does the same thing as glk_date_to_simple_time_utc(), but interprets the broken-out structure as local time.

glkdate_t

typedef struct {
    glsi32 year;     /* full (four-digit) year */
    glsi32 month;    /* 1-12, 1 is January */
    glsi32 day;      /* 1-31 */
    glsi32 weekday;  /* 0-6, 0 is Sunday */
    glsi32 hour;     /* 0-23 */
    glsi32 minute;   /* 0-59 */
    glsi32 second;   /* 0-59, maybe 60 during a leap second */
    glsi32 microsec; /* 0-999999 */
} glkdate_t;

This structure represents a human-readable date in a specific timezone.