khttp_epoch2tms.3

NAME

KHTTP_EPOCH2TM, khttp_epoch2tms — convert time to components

LIBRARY

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.

AUTHORS