1PLCTIME(3plplot) PLplot API PLCTIME(3plplot)
2
3
4
6 plctime - Calculate continuous time from broken-down time for the cur‐
7 rent stream
8
10 plctime(year, month, day, hour, min, sec, ctime)
11
13 Calculate continuous time, ctime, from broken-down time for the current
14 stream. The broken-down time is specified by the following parameters:
15 year, month, day, hour, min, and sec. This function is the inverse of
16 plbtime(3plplot).
17
18 The PLplot definition of broken-down time is a calendar time that com‐
19 pletely ignores all time zone offsets, i.e., it is the user's responsi‐
20 bility to apply those offsets (if so desired) before using the PLplot
21 time API. By default broken-down time is defined using the proleptic
22 Gregorian calendar without the insertion of leap seconds and continuous
23 time is defined as the number of seconds since the Unix epoch of
24 1970-01-01T00:00:00Z. However, other definitions of broken-down and
25 continuous time are possible, see plconfigtime(3plplot) which specifies
26 that transformation for the current stream.
27
28 Redacted form: General: plctime(year, month, day, hour, min, sec,
29 ctime)
30
31
32 This function is used in example 29.
33
35 year (PLINT(3plplot), input)
36 Input year.
37
38 month (PLINT(3plplot), input)
39 Input month in range from 0 (January) to 11 (December).
40
41 day (PLINT(3plplot), input)
42 Input day in range from 1 to 31.
43
44 hour (PLINT(3plplot), input)
45 Input hour in range from 0 to 23
46
47 min (PLINT(3plplot), input)
48 Input minute in range from 0 to 59.
49
50 sec (PLFLT(3plplot), input)
51 Input second in range from 0. to 60.
52
53 ctime (PLFLT_NC_SCALAR(3plplot), output)
54 Returned value of the continuous time calculated from the bro‐
55 ken-down time specified by the previous parameters.
56
57
59 Many developers (who are credited at http://plplot.org/credits.php)
60 have contributed to PLplot over its long history.
61
63 PLplot documentation at http://plplot.org/documentation.php.
64
65
66
67 January, 2023 PLCTIME(3plplot)