XFA Specification
Chapter 22, Canonical Format Reference
Time
798
Notes
●
The only punctuation character that is acceptable between date components is the hyphen character
(Unicode character U+002D.
●
Not all of these formats constitute a date to the precision of an actual day, hence it is up to the
application to determine whether "1997-07" is an acceptable date, i.e. is the application looking for a
particular
day,
in which case 1997-07 is not precise enough because it doesn't specify a day.
Time
Time must be expressed in any of the following forms:
HH[MM[SS[.FFF][z]]]
HH[MM[SS[.FFF][+HH[MM]]]]
HH[MM[SS[.FFF][-HH[MM]]]]
HH[:MM[:SS[.FFF][z]]]
HH[:MM[:SS[.FFF][-HH[:MM]]]]
HH[:MM[:SS[.FFF][+HH[:MM]]]]
Where the symbols have the following meaning:
Symbol
HH
MM
SS
FFF
z
Meaning
Zero-padded 2 digit (00-23) hour of the day, expressed as a 24-hour clock. (The
meridiem symbols AM and PM are not supported.)
2-digit (00-59) minute of the hour.
2-digit (00-59) second of the minute.
Decimal fraction of a second. Any fraction of a second is
always
preceded by a dot
(Unicode character U+002E) and must include exactly 3 digits.
[ISO-8601]
Z
,
+HH[MM]
, or
-HH[MM]
. In the examples on
page 799,
H
is a placeholder for an hour digit, and the
M
is a placeholder for a minute digit. The
value for z may have the following values:
●
Omitted. If time zone is omitted, states a local time with an unknown time zone.
Omitting the time zone information may cause a time data value to be useless to
applications that operate within other timezones. Producing time data that omit
timezone designators is discouraged.
Z. A time zone of 'Z' (Unicode character U+005A) indicates the time zone is 'zero
meridian', or 'Zulu Time'. The
[ISO-8601]
Universal Time Coordinated
describes a method of defining time absolutely. Another helpful document is
A Few
Facts Concerning GMT, UT, and the RGO,
by R. Langley, 20 January 1999, which is
available at
http://www.apparent-wind.com/gmt-explained.html.
+HH[MM] or -HH[MM]. A time zone expressed as an offset of plus or minus states
that the offset can be added to the time to indicate that the local time zone is HH
hours and MM minutes ahead or behind GMT. The plus or minus sign must be
included.
●
●
The symbols in the above table echo the time picture-clause symbols; however, they serve only to
describe (to the reader) expected values.