Re: ISO time format for tsStampToText

[Maren Purves <m.purves@jach.hawaii.edu>]

Hi all,

In the astronomy world FITS format is common, and uses timestamps
that start the same but are only the first 19 characters.
If a suggestion like Peregrine's gets implemented, can this
have an optional cutoff at the integer seconds?
At the JAC we currently have this implemented 2 ways, the older 
being in code, the newer one with a stringin in bc635 time card 
device support (Nick may correct me if I got this completely upside 
down).

Aloha,

Maren

Peregrine M. McGehee wrote:
> 
> At the Sloan Digital Sky Survey we are moving the timestamp
> formats for all observing software (both EPICS and non-EPICS)
> to that of ISO 8601 (http://www.w3.org/TR/NOTE-datetime).
> 
> I propose adding an option TS_TEXT_ISO to base/src/libCom/tsSubr.c:tsStampToText(). Lines beginning with
> an asterisk are copied from the R3.13.5 source code.
> 
> *       The required size of the caller's text buffer depends on the type
> *       of conversion being requested.  The conversion types, buffer sizes,
> *       and conversion formats are:
> *
> *       TS_TEXT_MONDDYYYY  32   Mon dd, yyyy hh:mm:ss.nano-secs
> *       TS_TEXT_MMDDYY     28   mm/dd/yy hh:mm:ss.nano-secs
> 
>         TS_TEXT_ISO        36   YYYY-MM-DDThh:mm:ss.nano-secsTZD
> 
>         (eg 1997-07-16T19:20:30.123456789+01:00)
> where:
> 
>      YYYY = four-digit year
>      MM   = two-digit month (01=January, etc.)
>      DD   = two-digit day of month (01 through 31)
>      hh   = two digits of hour (00 through 23) (am/pm NOT allowed)
>      mm   = two digits of minute (00 through 59)
>      ss   = two digits of second (00 through 59)
>      nano-secs    =  digits representing a decimal fraction of a second
>      TZD  = time zone designator (Z or +hh:mm or -hh:mm)
> 
> *       For any of the formats, the fractional part of the time (represented
> *       as `nano-secs' above) is variable length.  If the usec and nsec part
> *       of the time are both zero, only milli-seconds will be printed; or
> *       else if the nsec part is zero, only milli-seconds and micro-seconds
> *       will be printed.
> 
> Aloha,
>         Peregrine
> --
> Peregrine M. McGehee    peregrine@lanl.gov      (505) 667-3273
> Sloan Digital Sky Survey / Spallation Neutron Source
> MS H820, Los Alamos National Laboratory, Los Alamos, NM 87545