plctime: Calculate continuous time from broken-down time for the current stream

`plctime`: Calculate continuous time from broken-down time for the current stream
Prev | Chapter 17. The Common API for PLplot | Next

#### `plctime`: Calculate continuous time from broken-down time for the current stream

`plctime (` | year,
| month,
| day,
| hour,
| min,
| sec,
| ctime`)`;

Calculate continuous time, ``ctime``, from broken-down time for the current stream. The broken-down time is specified by the following parameters: ``year``, ``month``, ``day``, ``hour``, ``min``, and ``sec``. This function is the inverse of `plbtime`.

The PLplot definition of broken-down time is a calendar time that completely ignores all time zone offsets, i.e., it is the user's responsibility to apply those offsets (if so desired) before using the PLplot time API. By default broken-down time is defined using the proleptic Gregorian calendar without the insertion of leap seconds and continuous time is defined as the number of seconds since the Unix epoch of 1970-01-01T00:00:00Z. However, other definitions of broken-down and continuous time are possible, see `plconfigtime` which specifies that transformation for the current stream.

`year` (``PLINT``, input)

  Input year.

`month` (``PLINT``, input)

  Input month in range from 0 (January) to 11 (December).

`day` (``PLINT``, input)

  Input day in range from 1 to 31.

`hour` (``PLINT``, input)

  Input hour in range from 0 to 23

`min` (``PLINT``, input)

  Input minute in range from 0 to 59.

`sec` (``PLFLT``, input)

  Input second in range from 0. to 60.

`ctime` (``PLFLT_NC_SCALAR``, output)

  Returned value of the continuous time calculated from the broken-down time specified by the previous parameters.

Redacted form:

- General: `plctime(year, month, day, hour, min, sec, ctime)`

This function is used in example 29.

Prev | Up | Next
`plcpstrm`: Copy state parameters from the reference stream to the current stream | Home | `plend`: End plotting session