UTdate


Routine

char *UTdate (int format)

Purpose

Return a date/time string for the current time

Description

This routine returns a date/time string in a number of standard formats. Formats 0, 1 and 2 are in local time. Format 0 is the standard C-language format (without the trailing newline character). Format 1 includes the time zone abbreviation. Formats 0 and 1 use English abbreviations for the day of the week and the month. Format 2 avoids language dependent names (except for the time-zone code). Format 3 gives the date and time in GMT (Universal Coordinated Time). All fields are fixed length, except possibly the time zone abbreviation. The conversion process produces no more than 29 characters plus the terminating null character. This length allows for at least a 4 character representation of the time zone abbreviation.

 Format  Example                      time zone    length
   0    Sun Sep 16 01:03:52 1973      local time   24 + null
   1    Sun Sep 16 01:03:52 EST 1973  local time   28* + null
   2    1994/01/23 09:59:53 EST       local time   23* + null
   3    1994/01/23 14:59:53 UTC       GMT          23 + null
             (*) the time zone length can vary

Parameters

<- char *UTdate
Pointer to a character string for the date and time. This string is null terminated and most 29 characters long, not including the terminating null character. This is a pointer to an internal static storage area; each call to this routine overlays this storage.
-> int format
Date / time format code, taking on values from 0 to 3

Author / revision

P. Kabal Copyright (C) 1996 / Revision 1.11 1996/05/06


Main Index libtsp