/*-------------- Telecommunications & Signal Processing Lab ---------------
                             McGill University

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 $  $Date: 1996/05/06 20:35:08 $

-------------------------------------------------------------------------*/

static char rcsid[] = "$Id: UTdate.c 1.11 1996/05/06 AFsp-V2R1 $";

#include <time.h>
#include <libtsp.h>
#include <libtsp/nucleus.h>

#define MAXDATE	29

char *
UTdate (format)

     int format;

{
  static char Datetime[MAXDATE+1];
  time_t tnow;

  tnow = time ((time_t *) NULL);
  STcopyMax (UTctime (&tnow, format), Datetime, MAXDATE);

  return Datetime;
}