home | help
DC_DATETIME_LOCALTIME(3)     Library Functions Manual	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  local-
     time(3), or if available, localtime_r(3).

RETURN VALUES
     This  returns the result pointer on success.  It returns NULL if ticks can-
     not 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@libdivecom-
     puter.org.  The manpages were written by
     Kristaps Dzonsons, kristaps@bsd.lv.

FreeBSD ports 15.quarterly	January 11, 2017	DC_DATETIME_LOCALTIME(3)

home | help