<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:23. -->
<!-- Do not edit! -->
<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>ploticus: times</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
<table cellpadding=2 width=550><tr>
<td><br><h2>times</h2></td>
<td align=right>
<small>
<a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
Version 2.41 Mar2009
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for times(PL)</title>
</head>
<body>
<h2>Ploticus time support</h2>
Ploticus can plot time values directly.<tt> </tt>
There are several
<a href="functions.html">
functions
</a>
that may be useful when working with time values.<tt> </tt>
<br><br><br>
<h2>Supported time notations</h2>
<b>Clock times</b> must be in the range of 0:00:00 to 24:00:00.<tt> </tt>
<b>Elapsed times</b> have no upper limit, eg.
<tt>233:58:00</tt> is a valid elapsed time.<tt> </tt>
Time values must always be positive and
the minutes and seconds components must always be < 60.<tt> </tt>
<p>
The default notation is <tt>hh:mm</tt>.<tt> </tt>
<p>
<b>Clock time notations</b>
<ul>
<li>
<tt>hh:mm</tt> (example 11:25)
<li>
<tt>hh:mm:ss</tt> (example 11:25:02)
</ul>
<p>
<b>Elapsed time notations</b>
<ul>
<li>
<tt>hhh:mm</tt> (example 42:25)
<li>
<tt>hhh:mm:ss</tt> (example 42:25:02)
<li>
<tt>mm:ss</tt> (example 25:02) (minutes component must be < 60)
<li>
Seconds are floating-point values (see Fractional seconds, below).<tt> </tt>
<br><br><br>
</ul>
<h2>Using various time notations</h2>
To work with data having other time notations, use the
<i>format</i> portion of the
<tt>xscaletype</tt> or <tt>yscaletype</tt> attributes of <b>proc areadef</b>.<tt> </tt>
<br>
For example:
<pre>
#proc areadef
xscaletype: time mm:ss
</pre>
<br><br><br>
<h2>Display-only notations</h2>
In addition to the time arithmetic notations shown above,
the following formats may be used to display clock time values:
<ul>
<li>
<tt>hh:mma</tt> (examples: 11:25am, 0:40am 2:20pm)
<li>
<tt>hhA</tt> (examples: 11AM, 0AM, 2PM)
<li>
Others:
<tt>hh:mm:ssa m:ss hh mm m ss s</tt>
<br><br><br>
</ul>
<h2>Basic unit</h2>
The basic time unit is a <b>minute</b>, regardless of
which notation is in use.
Axis stubs and tics may be
expressed in <tt>hours</tt> or <tt>seconds</tt> if desired.<tt> </tt>
<br><br><br>
<h2>Fractional seconds</h2>
Seconds are represented as floating point values, and by default
only non-zero decimal components are displayed (<tt>%02g</tt>).<tt> </tt>
To control the displayed decimal format of seconds,
use a printf-style double format specifier instead of <tt>ss</tt>
in the time notation string.<tt> </tt>
For example, <tt>hh:mm:%02.02f</tt>
<p>
Stubs may be incremented by fractions of seconds, eg. <tt>stubs: inc 0.2 seconds</tt>
<br><br><br>
<h2>Key to notation codes</h2>
<p>
<tt>hhh</tt> = hours, elapsed time, no upper limit
<br>
<tt>hh</tt> = hours, 00 to 24 (00 to 11 for am/pm notation)
<br>
<tt>h</tt> = hours, 0 to 24, (0 to 11 for am/pm notation)
<br>
<tt>mm</tt> = minute 00 to 59
<br>
<tt>m</tt> = minute 0 to 59
<br>
<tt>ss</tt> = second 00.0 to < 60.0 (floating point, see above)
<br>
<tt>s</tt> = second 0.0 to < 60.0 (floating point, see above)
<br>
<tt>a</tt>i = am/pm notation (use <tt>A</tt> capitals e.g. AM or PM)
<br><br><br>
<h2>Notes</h2>
<p>
With am/pm notation noon is shown as eg. <tt>12N</tt>; midnight is eg. <tt>0AM</tt> or <tt>12AM</tt>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
<br>
<center>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> </td><td>
<a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12"
width="120" height="30" border="0"
alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a>
</td></tr></table>
</center>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 11, 2009.
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
ed05dc5f357c49fdded780f52b150dce
>
files
>
125
