XFA Specification
Chapter 24, Picture Clause Specification
Picture Clause Reference
919
Symbol
(U+FF39)
Full-width
(FW) or
ideographic
(I)
Is the picture symbol for …
I
I
I
FW
I, tens rule
1- or 2- digit full-width numeric value for the year value. (See
description for
“Y”.)
2-digit full-width numeric value for the year value. (See description for
“Y”.)
Prevailing-locale ideographic numeric value for year. (See description
for
“Y”.)
Full-width 4 digit year value. (See description for
“Y”.)
Tens rule prevailing-locale ideographic numeric value for year. (See
description for
“Y”.)
See also
“Global Picture-Clause Symbols” on page 902,
which describes
the symbols "
?
", "
*
", and "
+
".
The standard and full-width (
,
), dash (
-
), colon (
:
), slash (
/
), period (
.
) and space ( ) are treated as literals.
Requirements for Acceptable Date Picture Clauses
This section provides guidelines for writing acceptable date picture clauses. Please note that a picture
clauses used for input parsing have stricter guidelines than those used for output formatting.
Avoid Ambiguity in Date Picture Clauses Used for Input Parsing
Date picture clauses must be reasonably unambiguous; however, there are certain ambiguous date inputs
that can reasonably resolved into unambiguous expressions.
Examples of un-ambiguous date picture clauses follow:
MM/DD/YY
MM-DD-YY
DD.MM.YYYY
DD MMM YYYY
MMMM DD, YYYY
EEEE,' le 'D MMMM, YYYY
Examples of unacceptably ambiguous date picture clauses follow:
Example
Examples of acceptable ambiguous date picture clauses follow:
YYYYY
YYYY
YYY
YY
YYY
YYMD
Y
Unacceptably
ambiguous date picture
clause
Explanation
The year cannot be reasonably deduced with the information provided.
Date picture clauses with adjacent one letter picture symbols are ambiguous.
With a picture clause of
YYMD
, an input of "
99121
" can be evaluated as either
"
Jan 21, 1999
" or "
Dec 1, 1999
".