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

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

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

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

Calculate broken-down time; ``year``, ``month``, ``day``, ``hour``, ``min``, ``sec``; from continuous time, ``ctime`` for the current stream. This function is the inverse of `plctime`.

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

`year` (``PLINT_NC_SCALAR``, output)

  Returned value of years with positive values corresponding to CE (i.e., 1 = 1 CE, etc.) and non-negative values corresponding to BCE (e.g., 0 = 1 BCE, -1 = 2 BCE, etc.)

`month` (``PLINT_NC_SCALAR``, output)

  Returned value of month within the year in the range from 0 (January) to 11 (December).

`day` (``PLINT_NC_SCALAR``, output)

  Returned value of day within the month in the range from 1 to 31.

`hour` (``PLINT_NC_SCALAR``, output)

  Returned value of hour within the day in the range from 0 to 23.

`min` (``PLINT_NC_SCALAR``, output)

  Returned value of minute within the hour in the range from 0 to 59

`sec` (``PLFLT_NC_SCALAR``, output)

  Returned value of second within the minute in range from 0. to 60.

`ctime` (``PLFLT``, input)

  Continuous time from which the broken-down time is calculated.

Redacted form:

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

This function is used in example 29.

Prev | Up | Next
`plbox3`: Draw a box with axes, etc, in 3-d | Home | `plcalc_world`: Calculate world coordinates and corresponding window index from relative device coordinates