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)

       This function is used in example 29.

ARGUMENTS

       year (PLINT_NC_SCALAR(3plplot), 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(3plplot), output)
              Returned value of month within the year  in  the  range  from  0  (January)  to  11
              (December).

       day (PLINT_NC_SCALAR(3plplot), output)
              Returned value of day within the month in the range from 1 to 31.

       hour (PLINT_NC_SCALAR(3plplot), output)
              Returned value of hour within the day in the range from 0 to 23.

       min (PLINT_NC_SCALAR(3plplot), output)
              Returned value of minute within the hour in the range from 0 to 59

       sec (PLFLT_NC_SCALAR(3plplot), output)
              Returned value of second within the minute in range from 0. to 60.

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

AUTHORS

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

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                           April, 2024                           PLBTIME(3plplot)