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

NAME

6       pltimefmt - Set format for date / time labels
7

SYNOPSIS

9       pltimefmt(fmt)
10

DESCRIPTION

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
16       Redacted form: pltimefmt(fmt)
17
18       This function is used in example 29.
19

ARGUMENTS

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
83
84

AUTHORS

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

SEE ALSO

90       PLplot documentation at http://plplot.org/documentation.php.
91
92
93
94                                  July, 2023                PLTIMEFMT(3plplot)
Impressum