time.h revision 16201b15a6e228bf289f2448cb3b4d6ef47ff621
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Copyright (C) 2004-2009, 2012, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Copyright (C) 1998-2001 Internet Software Consortium.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Permission to use, copy, modify, and/or distribute this software for any
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * purpose with or without fee is hereby granted, provided that the above
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * copyright notice and this permission notice appear in all copies.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * PERFORMANCE OF THIS SOFTWARE.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/* $Id: time.h,v 1.40 2009/01/05 23:47:54 tbox Exp $ */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson#ifndef ISC_TIME_H
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson#define ISC_TIME_H 1
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*! \file */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson#include <isc/lang.h>
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson#include <isc/types.h>
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/***
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *** Intervals
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson ***/
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*!
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * \brief
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * The contents of this structure are private, and MUST NOT be accessed
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * directly by callers.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * The contents are exposed only to allow callers to avoid dynamic allocation.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonstruct isc_interval {
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson unsigned int seconds;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson unsigned int nanoseconds;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson};
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonextern const isc_interval_t * const isc_interval_zero;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * ISC_FORMATHTTPTIMESTAMP_SIZE needs to be 30 in C locale and potentially
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * more for other locales to handle longer national abbreviations when
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * expanding strftime's %a and %b.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson#define ISC_FORMATHTTPTIMESTAMP_SIZE 50
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonISC_LANG_BEGINDECLS
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonvoid
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_interval_set(isc_interval_t *i,
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson unsigned int seconds, unsigned int nanoseconds);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Set 'i' to a value representing an interval of 'seconds' seconds and
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * 'nanoseconds' nanoseconds, suitable for use in isc_time_add() and
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * isc_time_subtract().
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Requires:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li 't' is a valid pointer.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li nanoseconds < 1000000000.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_boolean_t
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_interval_iszero(const isc_interval_t *i);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Returns ISC_TRUE iff. 'i' is the zero interval.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Requires:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li 'i' is a valid pointer.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/***
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *** Absolute Times
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson ***/
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * The contents of this structure are private, and MUST NOT be accessed
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * directly by callers.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * The contents are exposed only to allow callers to avoid dynamic allocation.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonstruct isc_time {
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson unsigned int seconds;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson unsigned int nanoseconds;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson};
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonextern const isc_time_t * const isc_time_epoch;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonvoid
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_time_set(isc_time_t *t, unsigned int seconds, unsigned int nanoseconds);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Set 't' to a value which represents the given number of seconds and
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * nanoseconds since 00:00:00 January 1, 1970, UTC.
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob * Notes:
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *\li The Unix version of this call is equivalent to:
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *\code
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob * isc_time_settoepoch(t);
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob * isc_interval_set(i, seconds, nanoseconds);
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob * isc_time_add(t, i, t);
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *\endcode
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob * Requires:
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *\li 't' is a valid pointer.
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob *\li nanoseconds < 1000000000.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
e1f0415f3fc134cfc27757d7b015292bd623d9e4Brian Wellingtonvoid
e1f0415f3fc134cfc27757d7b015292bd623d9e4Brian Wellingtonisc_time_settoepoch(isc_time_t *t);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Set 't' to the time of the epoch.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Notes:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li The date of the epoch is platform-dependent.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Requires:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li 't' is a valid pointer.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_boolean_t
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_time_isepoch(const isc_time_t *t);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Returns ISC_TRUE iff. 't' is the epoch ("time zero").
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Requires:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li 't' is a valid pointer.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_result_t
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_time_now(isc_time_t *t);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Set 't' to the current absolute time.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Requires:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li 't' is a valid pointer.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Returns:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li Success
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li Unexpected error
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Getting the time from the system failed.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li Out of range
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * The time from the system is too large to be represented
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * in the current definition of isc_time_t.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson */
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_result_t
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonisc_time_nowplusinterval(isc_time_t *t, const isc_interval_t *i);
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson/*%<
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Set *t to the current absolute time + i.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * Note:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\li This call is equivalent to:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson *\code
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson * isc_time_now(t);
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob * isc_time_add(t, i, t);
*\endcode
*
* Requires:
*
*\li 't' and 'i' are valid pointers.
*
* Returns:
*
*\li Success
*\li Unexpected error
* Getting the time from the system failed.
*\li Out of range
* The interval added to the time from the system is too large to
* be represented in the current definition of isc_time_t.
*/
int
isc_time_compare(const isc_time_t *t1, const isc_time_t *t2);
/*%<
* Compare the times referenced by 't1' and 't2'
*
* Requires:
*
*\li 't1' and 't2' are valid pointers.
*
* Returns:
*
*\li -1 t1 < t2 (comparing times, not pointers)
*\li 0 t1 = t2
*\li 1 t1 > t2
*/
isc_result_t
isc_time_add(const isc_time_t *t, const isc_interval_t *i, isc_time_t *result);
/*%<
* Add 'i' to 't', storing the result in 'result'.
*
* Requires:
*
*\li 't', 'i', and 'result' are valid pointers.
*
* Returns:
*\li Success
*\li Out of range
* The interval added to the time is too large to
* be represented in the current definition of isc_time_t.
*/
isc_result_t
isc_time_subtract(const isc_time_t *t, const isc_interval_t *i,
isc_time_t *result);
/*%<
* Subtract 'i' from 't', storing the result in 'result'.
*
* Requires:
*
*\li 't', 'i', and 'result' are valid pointers.
*
* Returns:
*\li Success
*\li Out of range
* The interval is larger than the time since the epoch.
*/
isc_uint64_t
isc_time_microdiff(const isc_time_t *t1, const isc_time_t *t2);
/*%<
* Find the difference in microseconds between time t1 and time t2.
* t2 is the subtrahend of t1; ie, difference = t1 - t2.
*
* Requires:
*
*\li 't1' and 't2' are valid pointers.
*
* Returns:
*\li The difference of t1 - t2, or 0 if t1 <= t2.
*/
isc_uint32_t
isc_time_seconds(const isc_time_t *t);
/*%<
* Return the number of seconds since the epoch stored in a time structure.
*
* Requires:
*
*\li 't' is a valid pointer.
*/
isc_result_t
isc_time_secondsastimet(const isc_time_t *t, time_t *secondsp);
/*%<
* Ensure the number of seconds in an isc_time_t is representable by a time_t.
*
* Notes:
*\li The number of seconds stored in an isc_time_t might be larger
* than the number of seconds a time_t is able to handle. Since
* time_t is mostly opaque according to the ANSI/ISO standard
* (essentially, all you can be sure of is that it is an arithmetic type,
* not even necessarily integral), it can be tricky to ensure that
* the isc_time_t is in the range a time_t can handle. Use this
* function in place of isc_time_seconds() any time you need to set a
* time_t from an isc_time_t.
*
* Requires:
*\li 't' is a valid pointer.
*
* Returns:
*\li Success
*\li Out of range
*/
isc_uint32_t
isc_time_nanoseconds(const isc_time_t *t);
/*%<
* Return the number of nanoseconds stored in a time structure.
*
* Notes:
*\li This is the number of nanoseconds in excess of the number
* of seconds since the epoch; it will always be less than one
* full second.
*
* Requires:
*\li 't' is a valid pointer.
*
* Ensures:
*\li The returned value is less than 1*10^9.
*/
void
isc_time_formattimestamp(const isc_time_t *t, char *buf, unsigned int len);
/*%<
* Format the time 't' into the buffer 'buf' of length 'len',
* using a format like "30-Aug-2000 04:06:47.997" and the local time zone.
* If the text does not fit in the buffer, the result is indeterminate,
* but is always guaranteed to be null terminated.
*
* Requires:
*\li 'len' > 0
*\li 'buf' points to an array of at least len chars
*
*/
void
isc_time_formathttptimestamp(const isc_time_t *t, char *buf, unsigned int len);
/*%<
* Format the time 't' into the buffer 'buf' of length 'len',
* using a format like "Mon, 30 Aug 2000 04:06:47 GMT"
* If the text does not fit in the buffer, the result is indeterminate,
* but is always guaranteed to be null terminated.
*
* Requires:
*\li 'len' > 0
*\li 'buf' points to an array of at least len chars
*
*/
isc_result_t
isc_time_parsehttptimestamp(char *input, isc_time_t *t);
/*%<
* Parse the time in 'input' into the isc_time_t pointed to by 't',
* expecting a format like "Mon, 30 Aug 2000 04:06:47 GMT"
*
* Requires:
*\li 'buf' and 't' are not NULL.
*/
void
isc_time_formatISO8601(const isc_time_t *t, char *buf, unsigned int len);
/*%<
* Format the time 't' into the buffer 'buf' of length 'len',
* using the ISO8601 format: "yyyy-mm-ddThh:mm:ssZ"
* If the text does not fit in the buffer, the result is indeterminate,
* but is always guaranteed to be null terminated.
*
* Requires:
*\li 'len' > 0
*\li 'buf' points to an array of at least len chars
*
*/
void
isc_time_formatISO8601ms(const isc_time_t *t, char *buf, unsigned int len);
/*%<
* Format the time 't' into the buffer 'buf' of length 'len',
* using the ISO8601 format: "yyyy-mm-ddThh:mm:ss.sssZ"
* If the text does not fit in the buffer, the result is indeterminate,
* but is always guaranteed to be null terminated.
*
* Requires:
*\li 'len' > 0
*\li 'buf' points to an array of at least len chars
*
*/
ISC_LANG_ENDDECLS
#endif /* ISC_TIME_H */