Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
caltime(3)		   Library Functions Manual		    caltime(3)

NAME
       caltime - calendar dates	and times

SYNTAX
       #include	<caltime.h>

       unsigned	int caltime_fmt(s,&ct);
       unsigned	int caltime_scan(s,&ct);

       struct caltime ct;
       char *s;

DESCRIPTION
       A  struct  caltime  value is a calendar date and	time with an offset in
       minutes from UTC.  It has five components:  date	 (a  struct  caldate),
       hour   (0...23),	  minute   (0...59),   second	(0...60),  and	offset
       (-5999...5999).

       For example, a leap second occurred on 30 June 1997  at	23:59:60  UTC.
       The local time in New York was 30 June 1997 19:59:60 -0400.  This local
       time is represented inside a struct caltime with	date containing	 1997,
       6, 30; hour 19; minute 59; second 60; and offset	-240 (4	hours).

FORMATTING
       caltime_fmt prints ct in	ISO style (yyyy-mm-dd hh:mm:ss +oooo) into the
       character buffer	s, without a terminating NUL.  It returns  the	number
       of  characters  printed.	  s  may be zero; then caltime_fmt returns the
       number of characters that would have been printed.

       caltime_scan reads a calendar date, time, and offset in ISO style  from
       the  beginning of the character buffer s	and puts them into ct.	It re-
       turns the number	of characters read.  If	s does not start with an  ISO-
       style date and time (including offset), caltime_scan returns 0.

SEE ALSO
       caltime_tai(3), caldate(3), tai(3)

								    caltime(3)

NAME | SYNTAX | DESCRIPTION | FORMATTING | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=caltime&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help