ctime64(3C)															       ctime64(3C)

NAME

       ctime64(),  ctime64_r(),  difftime64(),	gmtime64(),  gmtime64_r(),  localtime64(),  localtime64_r(), mktime64() - convert date and time to
       string

SYNOPSIS

DESCRIPTION

       Converts the calendar time pointed to by
			 timer, representing the time in seconds since the Epoch, and return a pointer to the local time in the form of a  string.
			 Equivalent to:

       Is identical to	 except that it places the result in the user supplied and returns a pointer to upon success.  A buffer length of at least
			 26 is required.

       Returns the difference in seconds between two calendar times:
			 time1 - time0.

       Converts directly to Coordinated Universal Time (UTC),
			 the time standard used by the HP-UX operating system.	returns a pointer to the structure.

       Is identical to	 except that stores the result in the pointed to by and returns upon success.

       Corrects for the time zone and any summer time zone adjustments
			 (such as Daylight Savings Time in the USA), according to the contents of the environment variable (see below).  returns a
			 pointer to the structure.

       Is identical to	 except that stores the result in the pointed to by and returns upon success.

       Converts the broken-down time (expressed as local time)
			 in  the  structure pointed to by timeptr into a calendar time value with the same encoding as that of the values returned
			 by The original values of the and components of the structure are ignored, and the original values of	the  other  compo-
			 nents are not restricted to the ranges indicated below.

			 A  positive  or  zero value for causes to initially presume that Daylight Saving Time respectively is or is not in effect
			 for the specified time.  A negative value for causes to attempt to determine whether Daylight Saving Time  is	in  effect
			 for the specified time.

			 Upon  successful  completion,	all the components are set to represent the specified calendar time, but with their values
			 forced to the ranges indicated below.	The final value of is not set until and are  determined.   returns  the  specified
			 calendar time encoded as a value of type

			 The behavior of beyond the supported ranges is undefined.

       The  minimum  and  maximum dates supported by and are Friday December 13 20:45:52 UTC 1901 and Friday December 31 23:59:59 UTC 9999 respec-
       tively.

       and returns NULL and sets errno to if timer is less than the number of seconds that corresponds to the minimum  date  supported	(in  other
       words, as defined in or exceeds the number of seconds that corresponds to the maximum date supported.

       For more details on (see ctime(3C)).

EXTERNAL INFLUENCES

   Locale
       The category determines the interpretation of the bytes within format as single and/or multi-byte characters.

   Environment Variables
       The  function  uses  the contents of to set the values of the external variables and also determines the time zone name substituted for the
       and directives and the time zone adjustments performed by and Two methods for specifying a time zone within are described in environ(5).

   International Code Set Support
       Single and multibyte character code sets are supported.

RETURN VALUE

       For if the buffer is of insufficient length, a NULL is returned and errno set to

       and return a NULL and set errno to if NULL pointers are passed in as arguments.

       A NULL is returned and errno is set to if the input to the following routines is not within the supported range: and

APPLICATION USAGE

       The return values for and point to static data whose contents is overwritten by each call.

WARNINGS

       The range of extends to 61 to allow for the occasional one or two leap seconds.	However, the "seconds since the Epoch" value  returned	by
       (see  time(2))  and  passed  as	the  timer  argument does not include accumulated leap seconds.  The structure generated by and will never
       reflect any leap seconds.  Upon successful completion, forces the value of the component to the range [0,59].

AUTHOR

       was developed by HP.

SEE ALSO

       time(2), ctime(3C), setlocale(3C), tztab(4), environ(5), lang(5), langinfo(5), thread_safety(5).

																       ctime64(3C)