1PLTIMEFMT(3plplot) PLplot API PLTIMEFMT(3plplot)
2
6 pltimefmt - Set format for date / time labels
7
9 pltimefmt(fmt)
10
12 Sets the format for date / time labels. To enable date / time format
13 labels see the options to plbox(3plplot), plbox3(3plplot), and
14 plenv(3plplot).
15 Redacted form: pltimefmt(fmt)
17 This function is used in example 29.
19
21 fmt (PLCHAR_VECTOR(3plplot), input)
22 An ascii character string which is interpreted similarly to the
23 format specifier of typical system strftime routines except that
24 PLplot ignores locale and also supplies some useful extensions
25 in the context of plotting. All text in the string is printed
26 as-is other than conversion specifications which take the form
27 of a '%' character followed by further conversion specification
28 character. The conversion specifications which are similar to
29 those provided by system strftime routines are the following:
30 %a: The abbreviated (English) weekday name. %A: The full (Eng‐
31 lish) weekday name. %b: The abbreviated (English) month name.
32 %B: The full (English) month name. %c: Equivalent to %a %b %d
33 %T %Y (non-ISO). %C: The century number (year/100) as a 2-digit
34 integer. %d: The day of the month as a decimal number (range 01
35 to 31). %D: Equivalent to %m/%d/%y (non-ISO). %e: Like %d, but
36 a leading zero is replaced by a space. %F: Equivalent to
37 %Y-%m-%d (the ISO 8601 date format). %h: Equivalent to %b. %H:
38 The hour as a decimal number using a 24-hour clock (range 00 to
39 23). %I: The hour as a decimal number using a 12-hour clock
40 (range 01 to 12). %j: The day of the year as a decimal number
41 (range 001 to 366). %k: The hour (24-hour clock) as a decimal
42 number (range 0 to 23); single digits are preceded by a blank.
43 (See also %H.) %l: The hour (12-hour clock) as a decimal number
44 (range 1 to 12); single digits are preceded by a blank. (See
45 also %I.) %m: The month as a decimal number (range 01 to 12).
46 %M: The minute as a decimal number (range 00 to 59). %n: A new‐
47 line character. %p: Either "AM" or "PM" according to the given
48 time value. Noon is treated as "PM" and midnight as "AM". %r:
49 Equivalent to %I:%M:%S %p. %R: The time in 24-hour notation
50 (%H:%M). For a version including the seconds, see %T below. %s:
51 The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000
52 (UTC). %S: The second as a decimal number (range 00 to 60).
53 (The range is up to 60 to allow for occasional leap seconds.)
54 %t: A tab character. %T: The time in 24-hour notation
55 (%H:%M:%S). %u: The day of the week as a decimal, range 1 to 7,
56 Monday being 1. See also %w. %U: The week number of the cur‐
57 rent year as a decimal number, range 00 to 53, starting with the
58 first Sunday as the first day of week 01. See also %V and %W.
59 %v: Equivalent to %e-%b-%Y. %V: The ISO 8601 week number of the
60 current year as a decimal number, range 01 to 53, where week 1
61 is the first week that has at least 4 days in the new year. See
62 also %U and %W. %w: The day of the week as a decimal, range 0
63 to 6, Sunday being 0. See also %u. %W: The week number of the
64 current year as a decimal number, range 00 to 53, starting with
65 the first Monday as the first day of week 01. %x: Equivalent to
66 %a %b %d %Y. %X: Equivalent to %T. %y: The year as a decimal
67 number without a century (range 00 to 99). %Y: The year as a
68 decimal number including a century. %z: The UTC time-zone
69 string = "+0000". %Z: The UTC time-zone abbreviation = "UTC".
70 %+: The UTC date and time in default format of the Unix date
71 command which is equivalent to %a %b %d %T %Z %Y. %%: A literal
72 "%" character.
73 The conversion specifications which are extensions to those
74 normally provided by system strftime routines are the following:
75 %(0-9): The fractional part of the seconds field (including
76 leading decimal point) to the specified accuracy. Thus %S%3
77 would give seconds to millisecond accuracy (00.000). %.: The
78 fractional part of the seconds field (including leading decimal
79 point) to the maximum available accuracy. Thus %S%. would give
80 seconds with fractional part up to 9 decimal places if avail‐
81 able.
82
86 Many developers (who are credited at http://plplot.org/credits.php)
87 have contributed to PLplot over its long history.
88
90 PLplot documentation at http://plplot.org/documentation.php.
91 January, 2023 PLTIMEFMT(3plplot)