KHTTP_EPOCH2TMS(3)

NAME
KHTTP_EPOCH2TM, khttp_epoch2tms - convert time to components

LIBRARY
libkcgi

SYNOPSIS
#include <sys/types.h>
#include <stdarg.h>
#include <stdint.h>
#include <kcgi.h>
int
khttp_epoch2tms(int64_t epoch, int *tm_sec, int *tm_min, int *tm_hour, int *tm_mday, int *tm_mon, int *tm_year, int *tm_wday, int *tm_yday);
int
KHTTP_EPOCH2TM(int64_t epoch, struct tm *tm);

DESCRIPTION
Format an epoch value (seconds since Jan 1, 1970, 00:00:00 UTC) into its broken-down time components suitable for struct tm operations.

The components of khttp_epoch2tms() are filled in as follows:
tm_sec | seconds 0–59
tm_min | minutes 0–59
tm_hour | hours 0–23
tm_day | day of month 1–31
tm_mon | month 0–11
tm_year | year minus 1900
tm_yday | day in year 0–365
tm_wday | day in week 0–6 (Sunday = 0)

If any of the pointers are NULL, they are ignored.

The KHTTP_EPOCH2TM() macro fills in tm with the above values. Other fields in the struct tm structure, like tm_gmtoff, are not touched.

These deprecate the original kutil_epoch2tmvals() function and KUTIL_EPOCH2TM() macro, both of which had undefined behaviour in some corner cases.

For conversion without possible overflow or underflow, use khttp_epoch2datetime(3).

RETURN VALUES
These return zero on failure and non-zero on success. Failure occurs if epoch will overflow or underflow tm_year, which occurs around the year ±6.7+16.

SEE ALSO
khttp_datetime2epoch(3), khttp_epoch2datetime(3), khttp_epoch2str(3)

AUTHORS
Written by Kristaps Dzonsons <kristaps@bsd.lv>.