ploticus: times

## times | Welcome Gallery Handbook |
| Manual page for times(PL)

## 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)
`a`i = 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.