caldate

## Name

caldate — calendar dates

## Synopsis

    #include <caldate.h>

    unsigned int \fBcaldate_fmt\fP(\fIs\fR,&\fIcd\fR);

    unsigned int \fBcaldate_scan\fP(\fIs\fR,&\fIcd\fR);

    struct caldate \fIcd\fR;

    char *\fIs\fR;

## Description

A struct caldate value is a calendar date. It has three components: year, month (1...12), and day (1...31). caldate_fmt prints `cd` in ISO style (yyyy-mm-dd) into the character buffer `s`, without a terminating NUL. It returns the number of characters printed. `s` may be zero; then caldate_fmt returns the number of characters that would have been printed. caldate_scan reads a calendar date in ISO style from the beginning of the character buffer `s` and puts it into `cd`. It returns the number of characters read. If `s` does not start with an ISO-style date, caldate_scan returns 0.

## See also

caldate_mjd(3)
caltime(3)

## Author

Original code and documentation by Daniel J. Bernstein. Converted to DocBook XML by Jonathan de Boyne Pollard.