carta
time_time_t2dlp(3)

time_time_t2dlp3

Palmos time-conversion functions

Part of time_dlp2palmtime(3).

Usage

udword

time_t

void

void

Library

libpconn

Overview

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.

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.

From coldsync 3.0+pre3-3 in Debian 4.0 (Etch). Parsed by carta from the page's mdoc source.