Z Programs
Z.time.text
Arguments: A = time
(HHMM or NNNNN*)
B = format
indicator: Use H, h, M, m, A, a, N
(Capital letter means keep lead zero; Small letter means don't)
(Use 'A' or 'a' for AM/PM.
'A' means use 'AM' or 'PM'; 'a' = 'A' or 'P')
(N means to return military time)
(All other characters are taken literally)
Examples:
09:10am "H:MA"
9:10 a "h:M a"
9:10 am "h:M A"
0910 am "HM A"
0910a "HMa"
1530 "N" (with input as 1530)
C =
"C" to capitalize AM and PM
=
"S" to use small letters for am and pm
D = 1 to
indicate that argument A is internal time in seconds.
If A is NNNNN (seconds), it will be converted to HHMM *UNLESS* it
looks
like HHMM already. It is
best to pass in HHMM time. If you
cannot,
pass in D=1 so that the program knows that the time is in internal
form.
(i.e., 0000-2359 seconds is indistinguishable from 0000-2359 HHMM,
except
where X%1>59; however,
note that 2359 seconds is only = 0039 HHMM, a small
time window).
DEFAULTS:
B =
"h:MA" \___ e.g., 9:10am
C =
"S" /
Example call: %Z.time.text(1300,"h:mmA","C") Returns “1:00PM”
Posted: August 03, 2001