Manual page for times(PL)

Google




times
Welcome     Gallery     Handbook


Ploticus time support

Ploticus can plot time values directly. There are also several functions that deal with time values.


Supported notations

  • hh:mm (example 11:25)
  • hh:mm:ss (example 11:25:02)
  • mm:ss (example 25:02)
  • The default format is hh:mm.
  • Seconds are floating-point values (see Fractional seconds, below).

Using various time notations

To work with data having other time notations, use the format portion of the xscaletype or yscaletype attributes of proc areadef or proc defineunits.
For example: 
 #proc areadef
  xscaletype: time mm:ss



Display-only notations

In addition to the time arithmetic notations shown above, the following formats may be used to display time values:
  • hh:mma (example: 11:25am)
  • hhA (example: 11AM)
  • Others: hh:mm:ssa m:ss hh mm m ss s


Basic unit

The basic time unit is a minute, regardless of which notation is in use. Axis stubs and tics may be expressed in hours or seconds if desired.


Fractional seconds

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

Stubs may be incremented by fractions of seconds, eg. stubs: inc 0.2 seconds


Key to notation codes

hh = hour, 00 to 23 (00 to 11 for am/pm notation)
h = hour, 0 to 23, (0 to 11 for am/pm notation)
mm = minute 00 to 59
m = minute 0 to 59
ss = second 00.0 to < 60.0 (floating point, see above)
s = second 0.0 to < 60.0 (floating point, see above)
ai = am/pm notation (use A capitals e.g. AM or PM)


Notes

24:00 is generally considered equivalent to 00:00

With am/pm notation noon is shown as 12N; midnight is 12AM


data display engine  
Copyright Steve Grubb

Markup created by unroff 1.0,    December 10, 2002.