XFA Specification
Chapter 23, FormCalc Specification
String Built-in Functions
882
Parse()
This function parses the given data according to the given picture clause.
Syntax
Parse(s1, s2)
Parameters
s1
is a picture clause.
See “Picture Clause Specification” on page 901..
s2
is the string data being parsed.
Returns
The parsed data as a string, or the empty string if unable to parse the data. The data is formatted in
canonical format, as described in the chapter
“Canonical Format Reference” on page 797.
A successfully parsed date is returned as an ISO date string of the form YYYY-MM-DD.
A successfully parsed time is returned as an ISO time string of the form: HH:MM:SS.
A successfully parsed date-time is returned as an ISO date-time string of the form:
YYYY-MM-DDTHH:MM:SS.
A successfully parsed numeric picture clause is returned as a number.
A successfully parsed text pictures is format returned as text.
Examples
Parse("MMM D, YYYY", "Sep 1, 2002")
returns 2002-09-01.
Parse("$Z,ZZZ,ZZ9.99", "$1,234,567.89")
returns 1234567.89 in the US.
See Also
Format()
.