Bookmark and Share

time_palmtime2dlp (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 Unixstyle 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

Table of Contents

Popularne

Losowe