time_dlp2palmtime(3)

NAME
time_dlp2palmtime, time_dlp2time_t, time_palmtime2dlp, time_time_t2dlp - PalmOS time-conversion functions

LIBRARY
libpconn

SYNOPSIS
#include <time.h>
#include <palm.h>
#include <pconn/pconn.h>
udword
time_dlp2palmtime(const struct dlp_time *dlpt);
time_t
time_dlp2time_t(const struct dlp_time *dlpt);
void
time_palmtime2dlp(const udword palmt, struct dlp_time *dlpt);
void
time_time_t2dlp(const time_t t, struct dlp_time *dlpt);

DESCRIPTION
Palms use two different representations of time in different contexts. The first, Palm-style time_t, is an integer indicating the number of seconds elapsed since Jan. 1, 1904 (the Palm epoch).

The second representation is a structure listing the individual time fields, similar to a struct tm :

    struct dlp_time
    {
    	uword year;
    	ubyte month;
    	ubyte day;
    	ubyte hour;
    	ubyte minute;
    	ubyte second;
    };

(Note that year is the four-digit year number, e.g., 2001.)

time_dlp2palmtime takes a dlp_time and converts it to a Palm-style time_t.

time_dlp2time_t takes a dlp_time and converts it to a Unix-style time_t.

time_palmtime2dlp takes a Palm-style time_t and converts it to a dlp_time structure, writing the results to dlpt.

time_time_t2dlp takes a Unix-style time_t and converts it to a dlp_time structure, writing the results to dlpt.

RETURN VALUE
time_dlp2palmtime returns a Palm-style time_t.

time_dlp2time_t returns a Unix-style time_t.

SEE ALSO
libpconn(3), new_PConnection(3).

BUGS
Palm-style time_ts appear to count the number of seconds since the Palm epoch in the Palm's local time zone. However, it is not obvious how to find out which time zone the Palm thinks it is in, nor whether this is even possible.

Hence, these functions largely ignore the time zone, and hope for the best.