## times

Welcome Gallery Handbook

Manual page for times(PL)

## DESCRIPTION

Ploticus can plot time values directly.`` Time arithmetic may also be done using functions.`` This page describes the supported time formats (see KEY below for explanation of codes).``

## SUPPORTED FORMATS

- `hh:mm` (example 11:25)
- `hh:mm:ss` (example 11:25:02)
- `mm:ss` (example 25:02)

## DEFAULT FORMAT

The default format is `hh:mm`.``

## 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 FORMATS

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.``

## KEY TO CODE ABBREVIATIONS

`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 to 59
`s` = second 0 to 59
`a`i = am/pm notation (use `A` capitals e.g. AM or PM)

## NOTES

There are a number of functions for manipulating times that may be used in ploticus scripts.``
data display engine
Copyright Steve Grubb

Markup created by unroff 1.0, `` `` June 18, 2001.