NAME

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

SYNOPSIS

       plbtime(year, month, day, hour, min, sec, ctime)

DESCRIPTION

       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(3plplot).

       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(3plplot).

       Redacted form:  General: plbtime(year, month, day, hour, min, sec,  ctime)  Perl/PDL:  Not
       available?

       This function is used in example 29.

ARGUMENTS

       year (PLINT *, output)
              Output year.

       month (PLINT *, output)
              Output month in range from 0 (January) to 11 (December).

       day (PLINT *, output)
              Output day in range from 1 to 31.

       hour (PLINT *, output)
              Output hour in range from 0 to 23.

       min (PLINT *, output)
              Output minute in range from 0 to 59

       sec (PLFLT *, output)
              Output second in floating range from 0. to 60.

       ctime (PLFLT, input)
              Continous time from which the broken-down time is calculated.

AUTHORS

       Many  developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php) have
       contributed to PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                          February, 2016                         PLBTIME(3plplot)