XFA Specification
Chapter 24, Picture Clause Specification
Asian Date, Time and Number Considerations
910
Picture clause
null{’No data’}
| null{}
| text{999*9999}
| text{999*999*9999}
Input value
"555 1212"
"613 555 1212"
Parsed result
5551212
6135551212
""
Null
(Zero Length string)
"No data"
"Hello"
Null
Hello
a
a.The input value does not match any of the picture clauses, so is left as-is. That is, additional processing or validation
checks may be required before the data can be assumed to be in canonical format.
The following table presents examples of output formatting with alternate picture clauses.
Picture clause
null{’No data’}
| null{}
| text{999*9999}
| text{999*999*9999}
Input data
5551212
6135551212
Formatted result
"555 1212"
"613 555 1212"
Null
Hello
"No data"
"Hello"
a
a.The input data does not match any of the picture clauses, so it is unformatted.
Alternate Locale-Specific Picture Clauses
Picture clauses may be constructed as a set of alternate picture clauses, with each part containing a locale
identifier string. As with
“Alternate Picture Clauses”,
the alternate picture clauses are used only for input
parsing.
category(locale){picture-clause}|category(locale){picture-clause}
[|category(locale){picture-clause}]
The following table presents examples of input parsing with alternate picture clauses.
Picture clause
num(ar_SA){$z,zz9.zzs}|num(en_GB){$z,zz9.99}
Input value
€100.00
Parsed result
100
.
text(th_TH){999*9999}|text(th_TH_TH){999*9999}
.
,
100
5551212
5551212
555-1212
Asian Date, Time and Number Considerations
This section describes special considerations for describing East Asian eras in date and time picture
clauses.
Note:
Henceforth, this section uses the term
Asian
to denote East Asian locales.