DC_DATETIME_LOCALTIME(3)

NAME
dc_datetime_localtime - convert an timestamp to local date and time

LIBRARY
libdivecomputer

SYNOPSIS
#include <libdivecomputer/datetime.h>
dc_datetime_t *
dc_datetime_localtime(dc_datetime_t *result, dc_ticks_t ticks);

DESCRIPTION
Convert an integral timestamp ticks created with dc_datetime_now(3) or dc_datetime_mktime(3) into a broken-down local-time representation in result. The filled-in value consists of the year, month, day, hour, minute, and second fields.

Note: unlike in struct tm, the value for year is normalised, not less 1900; moreover, the value for month is from one, not zero.

The dc_datetime_localtime function may internally invoke libc's localtime(3), or if available, localtime_r(3).

RETURN VALUES
This returns the result pointer on success. It returns NULL if ticks cannot be sanely converted or if result is NULL.

SEE ALSO
dc_datetime_gmtime(3), dc_datetime_mktime(3), dc_datetime_new(3)

AUTHORS
The libdivecomputer library was written by Jef Driesen, jef@libdivecomputer.org. The manpages were written by Kristaps Dzonsons, kristaps@bsd.lv.