.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>quisp: times</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="quisp_home.html">
<img src="img/quisp2.gif" border=0><br><small>quick server pages</a> &nbsp; &nbsp; </td></tr>
<td>
.>>

.TH times TDH "16-MAR-2004   TDH scg@jax.org" 


.SH Supported time notations
\fBClock times\fR must be in the range of 0:00:00 to 24:00:00.
\fBElapsed times\fR have no upper limit, eg. 
\fC233:58:00\fR is a valid elapsed time.
Time values must always be positive and
the minutes and seconds components must always be < 60.
.LP
The default notation is \fChh:mm\fR.
.LP
\fBClock time notations\fR
.IP \(bu
\fChh:mm\fR (example  11:25)
.IP \(bu
\fChh:mm:ss\fR (example  11:25:02)
.LP
\fBElapsed time notations\fR
.IP \(bu
\fChhh:mm\fR (example  42:25)
.IP \(bu
\fChhh:mm:ss\fR (example  42:25:02)
.IP \(bu
\fCmm:ss\fR (example  25:02) (minutes component must be < 60)
.IP
Seconds are floating-point values (see Fractional seconds, below).

.ig >>
<br><br><br>
.>>


.SH Display-only notations
In addition to the time arithmetic notations shown above,
the following formats may be used to display clock time values:
.IP \(bu
\fChh:mma\fR (examples: 11:25am, 0:40am 2:20pm)
.IP \(bu
\fChhA\fR (examples: 11AM, 0AM, 2PM)
.IP \(bu
Others:
\fChh:mm:ssa    m:ss    hh     mm    m    ss    s\fR

.ig >>
<br><br><br>
.>>

.SH Basic unit
The basic time unit is a \fBminute\fR, regardless of
which notation is in use.  

.ig >>
<br><br><br>
.>>

.SH Fractional seconds
Seconds are represented as floating point values, and by default 
only non-zero decimal components are displayed (\fC%02g\fR).
To control the displayed decimal format of seconds,
use a printf-style double format specifier instead of \fCss\fR
in the time notation string.
For example, \fChh:mm:%02.02f\fR


.ig >>
<br><br><br>
.>>

.SH Key to notation codes    
.LP
\fChhh\fR = hours, elapsed time, no upper limit
.br
\fChh\fR = hours, 00 to 24 (00 to 11 for am/pm notation)
.br
\fCh\fR = hours, 0 to 24, (0 to 11 for am/pm notation)
.br
\fCmm\fR = minute 00 to 59
.br
\fCm\fR = minute 0 to 59
.br
\fCss\fR = second 00.0 to < 60.0  (floating point, see above)
.br
\fCs\fR = second 0.0 to < 60.0  (floating point, see above)
.br
\fCa\fRi = am/pm notation (use \fCA\fR capitals e.g. AM or PM)

.ig >>
<br><br><br>
.>>

.SH Notes
.LP
With am/pm notation noon is shown as eg. \fC12N\fR; midnight is eg. \fC0AM\fR or \fC12AM\fR


.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="quisp_home.html">
<img src="img/quisp2.gif" border=0></a><br>
<small>quick server pages &nbsp; &nbsp;<br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp; &nbsp;
</td></tr>
</table>
.>>
