oracular (3) plbtime.3plplot.gz

Provided by: plplot-doc_5.15.0+dfsg2-11build6_all bug

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.

                                                  August, 2024                                  PLBTIME(3plplot)