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 indi

vidual 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.

BSD Aug 16, 2001

BSD