Your company here — click to reach over 10,000 unique daily visitors

plbtime.3plplot - Man Page

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


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.


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.


May, 2024 PLplot API