1PLBTIME(3plplot)                  PLplot API                  PLBTIME(3plplot)
2
3
4

NAME

6       plbtime  - Calculate broken-down time from continuous time for the cur‐
7       rent stream
8

SYNOPSIS

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

DESCRIPTION

13       Calculate broken-down time; year, month, day, hour, min, sec; from con‐
14       tinuous  time,  ctime for the current stream.  This function is the in‐
15       verse of plctime(3plplot).
16
17       The PLplot definition of broken-down time is a calendar time that  com‐
18       pletely ignores all time zone offsets, i.e., it is the user's responsi‐
19       bility to apply those offsets (if so desired) before using  the  PLplot
20       time  API.   By default broken-down time is defined using the proleptic
21       Gregorian calendar without the insertion of leap seconds and continuous
22       time  is  defined  as  the  number  of  seconds since the Unix epoch of
23       1970-01-01T00:00:00Z. However, other  definitions  of  broken-down  and
24       continuous time are possible, see plconfigtime(3plplot).
25
26       Redacted  form:  General:  plbtime(year,  month,  day,  hour, min, sec,
27       ctime)
28
29
30       This function is used in example 29.
31

ARGUMENTS

33       year (PLINT_NC_SCALAR(3plplot), output)
34              Returned value of years with positive values corresponding to CE
35              (i.e.,  1 = 1 CE, etc.) and non-negative values corresponding to
36              BCE (e.g., 0 = 1 BCE, -1 = 2 BCE, etc.)
37
38       month (PLINT_NC_SCALAR(3plplot), output)
39              Returned value of month within the year  in  the  range  from  0
40              (January) to 11 (December).
41
42       day (PLINT_NC_SCALAR(3plplot), output)
43              Returned  value  of  day within the month in the range from 1 to
44              31.
45
46       hour (PLINT_NC_SCALAR(3plplot), output)
47              Returned value of hour within the day in the range from 0 to 23.
48
49       min (PLINT_NC_SCALAR(3plplot), output)
50              Returned value of minute within the hour in the range from 0  to
51              59
52
53       sec (PLFLT_NC_SCALAR(3plplot), output)
54              Returned  value  of second within the minute in range from 0. to
55              60.
56
57       ctime (PLFLT(3plplot), input)
58              Continuous time from which the broken-down time is calculated.
59
60

AUTHORS

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

SEE ALSO

66       PLplot documentation at http://plplot.org/documentation.php.
67
68
69
70                                 August, 2021                 PLBTIME(3plplot)
Impressum