Functions Reference

The World Wide Web (W3C) specification for XQuery supports a discrete set of functions. BEA Liquid Data for WebLogic^TM supports a subset of those functions as built-in functions. The Liquid Data built-in functions are accessible in the Data View Builder from Builder Toolbar—>Toolbox tab—>Functions panel. (See also Functions in Starting the Builder and Touring the GUI.)

For more information on the functions described here, see also:

• W3C XQuery 1.0 and XPath 2.0 Functions and Operators specification.

• Appendix D, the Function and Operator Quick Reference in the XQuery 1.0 and XPath 2.0 Functions and Operators specification

• XML Schema Part 2: Datatypes

This section provides a complete reference of the W3C functions supported in Liquid Data. This functions reference is organized by category as follows:

• Data Types

• Occurrence Indicators

• Accessor Functions

• Aggregate Functions

• Boolean Functions

• Constructor Functions

• DateTime Functions

• Node Functions

• Numeric Functions

• Comparison and Numeric Operators

• Other Functions

• Sequence Functions

• Type Casting Functions

 

---

Data Types

Every data element or variable has a data type. Function parameters have data type requirements and the function result is returned as a data type. The following table describes other data types that conform to the XQuery specification. Current compliance with the W3C XQuery specification extends to XQuery 1.0 and XPath 2.0 Functions and Operators specification dated 30 April 2002. Another helpful reference is XML Schema Part 2: Datatypes.

Table A-1 Data Types

Data Type Name	Description
xs:anyType	Represents the most generic data type. All data types including anyAttribute, anyElement, anySimpleType, anyValue, as well as sequences, items, nodes, strings, decimals.
xsext:anyValue	A subset of xs:anyType including dateTime, boolean, string, numeric values, or any single value. Does not include anyAttribute, anyElement, item, node, sequence, or anySimpleType.
xs:boolean	A subset of xsext:anyValue. A value that supports the mathematical concept of binary-valued logic: true or false.
xs:byte	A subset of xs:short. A sequence of decimal digits (0-9) with a range of 127 to -128. If the sign is omitted, plus  (+) is assumed. Examples: -1, 0, 126, +100
xs:date	A subset of xsext:anyValue. Represents the leftmost component of dateTime YYYY-MM-DD where: YYYY is the year MM is the month DD is the day May be preceded by a leading minus  (-) sign to indicate a negative number. If the sign is omitted, plus  (+) is assumed. May be immediately followed by a Z to indicate Coordinated Universal Time (UTC) or, to indicate the time zone (the difference between the local time and Coordinated Universal Time), immediately followed by a sign, + or -, followed by the difference from UTC represented as hh:mm. Example: To specify 1:20 pm on May the 31st, 1999, write: 1999-05-31.
xs:dateTime	A subset of xsext:anyValue. Represents the format YYYY-MM-DDThh:mm:ss where: YYYY is the year MM is the month DD is the day T is the date/time separator hh is the hour mm is the minute ss is the second May be preceded by a leading minus  (-) sign to indicate a negative number. If the sign is omitted, plus  (+) is assumed. Additional digits can be used to increase the precision of fractional seconds if desired (ss.ss...) with any number of digits after the decimal point is supported. May be immediately followed by a Z to indicate Coordinated Universal Time (UTC) or, to indicate the time zone (the difference between the local time and Coordinated Universal Time), immediately followed by a sign, + or -, followed by the difference from UTC represented as hh:mm. Example: To specify 1:20 pm on May the 31st, 1999 EST, which is five hours behind Coordinated Universal Time (UTC), write: 1999-05-31T13:20:00-05:00.
xs:decimal	A subset of xsext:anyValue. Includes all integer types, such as xs:integer, xs:long, xs:short, xs:int, or xs:byte. Represents a finite-length sequence of decimal digits (0-9) separated by an optional period as a decimal indicator. An optional leading sign is allowed. If the sign is omitted, plus  (+) is assumed. Leading and trailing zeroes are optional. If the fractional part is zero, the period and following zeroes can be omitted. Examples: -1.23, 12678967.543233, +100000.00, 210
xs:double	A subset of xsext:anyValue. There are no subordinate data types; however, xs:float and xs:decimal, and all derived types, can be promoted to xs:double in certain cases, such as function calls. Represents a double precision 64-bit floating point value. Supports the special values positive and negative zero, positive and negative infinity and not-a-number (0, -0, INF, -INF and NaN).
xs:float	A subset of xsext:anyValue. There are no subordinate data types; however, xs:decimal, and all derived types, can be promoted to xs:float in certain cases, such as function calls. Represents a single-precision 32-bit floating point value. Supports the special values positive and negative zero, positive and negative infinity and not-a-number (0, -0, INF, -INF and NaN).
xsext:item	A subset of xs:anyType. Includes xsext:anyValue and xsext:node. Excludes any sequence. Represents a list element, individual value, or attribute.
xs:int	A subset of xs:long. Represents a finite-length sequence of decimal digits (0-9). An optional leading sign is allowed. If the sign is omitted, plus  (+) is assumed. Examples: -1, 0, 12678967543233, +100000
xs:integer	A subset of xs:decimal. Represents a finite-length sequence of decimal digits (0-9). An optional leading sign is allowed. If the sign is omitted, plus  (+) is assumed. Examples: -1, 0, 12678967543233, +100000
xs:long	A subset of xs:decimal. A sequence of decimal digits (0-9) with a range of 9223372036854775807 to -9223372036854775808. If the sign is omitted, plus  (+) is assumed. Examples: -1, 0, 12678967543233, +100000
xsext:node	A subset of xsext:anyValue. A component in a tree structure that represents a data element.
xs:short	A subset of xs:int. A sequence of decimal digits (0-9) with a range of 32767 to -32768. If the sign is omitted, plus  (+) is assumed. Examples: -1, 0, 12678, +10000
xs:string	A subset of xsext:anyValue. A sequence that contains alphabetic, numeric, or special characters.
xs:time	A subset of xsext:anyValue. Represents the rightmost segment of the dateTime format where: hh is the hour mm is the minute ss is the second May contain an optional following time zone indicator. Examples: To indicate 1:20 pm EST, which is five hours behind Coordinated Universal Time (UTC), write: 13:20:00-05:00. Midnight is 00:00:00.

 

Naming Conventions

The xf: prefix is a W3C XML naming convention, also known as a namespace. Liquid Data supports extended functions that are enhancements to the XQuery specification, which you can recognize by their extended function prefix xfext:. For example, the full XQuery notation for an extended function is xfext:function_name. Extended functions accept standard input types, but they are limited to single values.

Liquid Data also supports extensions to XQuery data types that are designated with xsext:datatype notation. When you encounter the xsext: prefix, it means that the data type may have Liquid Data-imposed restrictions that are necessary to interface successfully with the Liquid Data Server.

The xfext: prefix identifies an extended function. The prefix identifies the type of function to you but the Data View Builder does not recognize or process the prefix.

 

---

Occurrence Indicators

An occurrence indicator indicates the number of items in a sequence. This notation usually appears on a parent node in a schema. Use these identifiers to determine the repeatability of a node.

• A question mark (?) indicates zero items or one single item.

• An asterisk (*) indicates zero or more items.

• A plus sign (+) indicates one or more items.

These occurrence indicators also communicate information about the data type when they appear in a function signature. For example:

• xs:integer* represents a list of zero or more integers.

• string+ represents a list of one or more strings.

• decimal? represents zero or one decimal values. Therefore, the decimal value is optional.

 

---

Accessor Functions

Accessor functions operate on different types of nodes. They accept single node input and return a value based on the node type.

Table A-2 Accessor Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:data	Data Type: Input data type: xsext:node? Returned data type: xsext:anyValue? Description: Returns the typed-value of each input node. Examples: xf:data(<a>{3}</a>) returns the numeric value 3. xf:data(<a/>) returns an empty list (). xf:data((<a>{3}</a>, <a>{7}</a>)) generates a compile-time error because the parameter is a list of nodes. xf:data(<date location="SD">2002-07-12</date>) returns the string value "2002-07-12.". xf:data(3) generates a compile-time error because 3 is not a node.	Notes: If the source value is not a node, the function returns an error. XQuery Specification Compliance: Liquid Data does not use a list of nodes; it uses only an optional node. Liquid Data does not generate an error when you specify a document node. It returns an empty list.

 

 

---

Aggregate Functions

Aggregate functions process a sequence as argument and return a single value computed from values in the sequence. Except for the Count function, if the sequence contains nodes, the function extracts the value from the node and uses it in the computation.

Note: In the Data View Builder, you cannot drag and drop aggregate functions to the work area. You must double-click on them to open them so that you can select input parameters.

Table A-3 Aggregate Functions

Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:avg	Data Type: Input data type: xs:double* Returned data type: xs:double? Description: Returns the average of a sequence of numbers. Examples: xf:avg((4, 10)) returns the double precision floating point value 7.0. xf:avg((4, (), 10)) also returns the double precision floating point value 7.0. xf:avg((4, "10")) generates a compile-time error because the input sequence contains a string.	Notes: If the source value contains nodes, the value of each node is extracted using the xf:data function. If an empty list occurs, it is discarded. If the source value contains only numbers, the Avg function returns the average of the numbers, which is the sum of the source sequence divided by the count of the source sequence. If the source value is an empty list, the function returns an empty list. If the source value contains non-numeric data, the function returns an error. XQuery Specification Compliance: Liquid Data requires a list of double precision values instead of a list of items.
xf:count	Data Type: Input data type: xs:item* Returned data type: xs:integer Description: Returns the number of items in the sequence in an unsigned integer. Examples: xf:count((3, "10")) returns the integer value 2. xf:count(()) returns the integer value 0. xf:count((3, "10", (), )) returns the value 3 (the empty list is ignored).	Notes: If the source value is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data returns an integer value (xs:integer) instead of an unsigned int (xs:unsignedInt) value.
xf:max	Data Type: Input data type: xsext:item* Returned data type: xsext:item? Description: Returns the maximum value from a sequence. If there are two or more items with the same value, the specific item whose value is returned is implementation-dependent. Examples: xf:max((3, 10)) returns the value 10. xf:max((<a>{4}</a>, 3, (), <b >{2}</b>)) returns <a>{4}</a>.	Notes: If the source value contains nodes, the value of each node is extracted using the xf:data function. If an empty list occurs, it is discarded. All values in the list must be instances of one of the following types: numeric xs:string xs:date xs:time xs:dateTime For example, if the list contains items with typed values that represent both decimal values and dates, an error will occur. The values in the sequence must have a total order: DateTime values must all contain a time zone or omit a time zone. Duration values must contain only years and months or contain only days, hours, minutes and seconds. Both of these conditions must be true; otherwise, the function returns an error. XQuery Specification Compliance: Liquid Data does not support a format with a collation literal. Liquid Data has no restrictions on date and time input values. Liquid Data supports a correct return type of xs:item? instead of xs:anySimpleType?, which is incorrect. Liquid Data supports only numeric, xs:string, xs:date, xs:time, and xs:dateTime data types.
xf:min	Data Type: Input data type: xsext:item* Returned data type: xsext:item? Description: Returns the minimum value from a sequence of numbers. If there are two or more items with the same value, the specific item whose value is returned is implementation-dependent. Examples: xf:min((3, 10)) returns the value 3. xf:min((<a>{4}</a>, 3, (), <b>{2}</b>)) returns <b>{2}</b>. xf:min((3, 4, "2")) generates an error because the sequence contains both numeric and string values. xf:min(()) returns an empty list ().	Notes: If the source value contains nodes, the value of each node is extracted using the Data function. If an empty list occurs, it is discarded. After extracting the values from nodes, the sequence must contain only values of a single type. The values in the sequence must have a total order: DateTime values must all contain a time zone or omit a timezone Duration values must contain only years and months or contain only days, hours, minutes and seconds Both of these conditions must be true; otherwise, the function returns an error. XQuery Specification Compliance: Liquid Data does not support a format with a collation literal. Liquid Data has no restrictions on date and time input values. Liquid Data supports a correct return type of xs:item? instead of xs:anySimpleType?, which is incorrect. Liquid Data supports only numeric, xs:string, xs:date, xs:time, and xs:dateTime data types.
xf:sum	Data Type: Input data type: xsext:anyValue* Returned data type: xsext:anyValue? Description: Returns the sum of a sequence of numbers. Examples: xf:sum((3, 8, (), 1)) returns the value 12. xf:sum(()) returns an empty list (). xf:sum((<a>{4}</a>, 3)) returns a value of 7. xf:sum(("7", 3)) generates a compile-time error because the sequence that is passed in to the function is not homogenous.	Notes: If the source value contains nodes, the value of each node is extracted using the Data function. If an empty list occurs, it is discarded. If the source value contains only numbers, the Sum function returns the sum of the numbers. If the source value contains non-numeric data, the function returns an error. If the input sequence is empty, the function returns an empty list. XQuery Specification Compliance: Liquid Data adheres to the prior XQuery specification (December, 2001) by returning an empty list if the input sequence is empty. Liquid Data output depends on the input type. If the input type is xs:decimal, the returned value is xs:decimal; if the input type is xs:decimal and xs:float, the returned value is xs:float; if the input type is xs:double, the returned value is xs:double.

 

 

---

Boolean Functions

Boolean functions return true or false values.

Table A-4 Boolean Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Compliance
xf:false	Data Types: Input data type: No input data required. Returned data type: xs:boolean Description: Returns the boolean value false. Examples: xf:false() returns false. xf:false(34) generates a compile-time error because the function does not accept any parameters.	XQuery Specification Compliance: Conforms to the current specification.
xf:not	Data Types: Input data type: xs:boolean? Returned data type: xs:boolean? Description: Returns true if the value of the source value is false and false if the value of the source value is true. Examples: xf:not(xf:false()) returns the boolean value true. xf:not(xf:true()) returns the boolean value false. xf:not(32) generates a compile-time error because the input value is not boolean. xf:not(()) returns the boolean value true.	XQuery Specification Compliance: Liquid Data accepts an optional boolean value instead of a sequence as input. Liquid Data returns a true value if the input is an empty list. Liquid Data returns an optional boolean value instead of one boolean value.
xf:true	Data Types: Input data type: No input data required. Returned data type: xs:boolean Description: Returns the boolean value true. Examples: xf:true() returns true. xf:true("34") generates a compile-time error because the function does not accept any parameters.	XQuery Specification Compliance: Conforms to the current specification.

 

 

---

Constructor Functions

Constructor functions process a source value as the argument. Every data element or variable has a data type. The data type determines the value that any function parameter can contain and the operations that can be performed on it. The Liquid Data supports the following type casting functions.

Table A-5 Accessor Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:boolean-from-string	Data Types: Input data type: xs:string? Returned data type: xs:boolean? Description: Returns a boolean value of true or false from the string source value. Examples: xf:boolean-from-string("true") returns the boolean value true. xf:boolean-from-string("FaLSe") returns the boolean value false. xf:boolean-from-string("43") generates a runtime error because the input value cannot be parsed into a boolean value. xf:boolean-from-string(43) generates a compile-time error because the input value is not a string.	Notes: If the input parameter is empty, the function returns an empty list. Otherwise, Liquid Data generates an error. XQuery Specification Compliance: Conforms to the current specification; however, Liquid Data does not accept the values "1" and "0" to represent true and false, as described in the W3C XML Schema document.
xf:byte	Data Types: Input data type: xsext:anyValue? Returned data type: xs:byte? Description: Constructs a byte integer value from the string source value. Examples: xf:byte('127') returns the byte value one hundred twenty seven. xf:byte(38) returns the byte value 38. xf:byte("-4") returns the byte value -4. xf:byte(128) returns the byte value -128 because the number wraps. xf:byte(-129) returns the byte value 127 because the number wraps. xf:byte(xf:true()) returns the byte value 1. xf:byte(xf:false()) returns the byte value 0. xf:byte("true") generates a runtime error because the string literal cannot be converted to a byte value. xf:byte('128') returns an error because one hundred twenty eight is invalid for a byte integer expression.	Notes: An error occurs if the source value is greater than 127 or less than -128. Liquid Data truncates the input if it is a non-integer number. If the number falls outside of the range of byte values, the number wraps. If the number is an integer that falls within the range, the value is unchanged. If the input is a string, Liquid Data tries to parse it into a byte value. If the input is the boolean value true, the function returns 1. If it is false, it returns 0. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value and convert it at run time.
xf:decimal	Data Types: Input data type: xsext:anyValue? Returned data type: xs:decimal? Description: Constructs a decimal value from the source value. Examples: xf:decimal("3") returns the decimal value 3. xf:decimal(99.1) returns the decimal value 99.1 (the same value that is input to the function). xf:decimal(xf:true()) returns the decimal value 1. xf:decimal(xf:false()) returns the decimal value 0. xf:decimal("true") generates a runtime error because the string literal cannot be converted to a decimal value.	XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time. Liquid Data supports "e" and "E" to construct floating point integer values.
xf:double	Data Types: Input data type: xsext:anyValue? Returned data type: xs:double? Description: Constructs a double precision value from the source value. Examples: xf:double("3") returns the double precision floating point value 3.0. xf:double(5.1) returns the double precision floating point value 5.1. xf:double(xf:true()) returns the double precision floating point value 1.0. xf:double(xf:false()) returns the double precision floating point value 0.0. xf:double("true") generates a runtime error because the string literal cannot be converted to a double precision floating point value. xf:double("12345678901234567890") evaluates to the double precision floating point value 1.2345678901234567E19.	XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:float	Data Types: Input data type: xsext:anyValue? Returned data type: xs:float? Description: Constructs a floating point value from the source value. Examples: xf:float(1) returns the floating-point value 1.0. xf:float("1") returns the floating-point value 1.0. xf:float(xf:true()) returns the floating point value 1.0. xf:float(xf:false()) returns the floating-point value 0.0. xf:float("true") generates a runtime error because the string literal cannot be converted to a floating-point value. xf:float("12345678901234567890") returns the floating-point value 1.2345679E19.	XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:int	Data Types: Input data type: xsext:anyValue? Returned data type: xs:integer? Description: Constructs an integer value from the source value. The largest integer value is limited to a 32-bit expression. Examples: xf:int(4056) returns the int value 4056. xf:int("-35") returns the int value -35. xf:int(xf:true()) returns the int value 1. xf:int(xf:false()) returns the int value 0. xf:int("true") generates a runtime error because the string literal cannot be converted to an int value.	Notes: An error occurs if the source value is greater than 2,147,483,647 or less than -2,147,483,648. To the Liquid Data Server, the xf:int function is exactly the same as the xf:integer function. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:integer	Data Types: Input data type: xsext:anyValue? Returned data type: xs:integer? Description: Constructs an integer value from the source value. The largest integer value is limited to a 32-bit expression. Examples: xf:integer(4056) returns the int value 4056. xf:integer("-35") returns the int value -35. xf:integer(xf:true()) returns the int value 1. xf:integer(xf:false()) returns the int value 0. xf:integer("true") generates a runtime error because the string literal cannot be converted to an int value.	Notes: An error occurs if the source value is greater than 2,147,483,647 or less than -2,147,483,648. To the Liquid Data Server, the xf:integer function is exactly the same as the xf:int function. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:long	Data Types: Input data type: xsext:anyValue? Returned data type: xs:long? Description: Constructs a four-byte integer value from the source value. Use a long integer data type when the value exceeds the limitations imposed by other integer data types. Examples: xf:long(1) returns the long integer value 1. xf:long("-91") returns the long integer value -91. xf:long(xf:true()) returns the long integer value 1. xf:long(xf:false()) returns the long integer value 0. xf:long("true") generates a runtime error because the string literal cannot be converted to a long integer value.	Notes: An error occurs if the source value is greater than 9,223,372,036,854,775,807 or less than -9,223,372,036,854,775,808. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:short	Data Types: Input data type: xsext:anyValue? Returned data type: xs:short? Description: Constructs a two-byte integer value from the source value. The largest short integer value is limited to a 16-bit expression. Examples: xf:short(1) returns the short integer value 1. xf:short("-91") returns the short integer value -91. xf:short(xf:true()) returns the short integer value 1. xf:short(xf:false()) returns the short integer value 0. xf:short("true") generates an error because the string literal cannot be converted to a short integer value.	Notes: An error occurs if the source value is greater than 32,767 or less than -32,768. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN) or -0. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xf:string	Data Types: Input data type: xs:anyType Returned data type: xs:string? Description: Constructs a string value from the source value. The source value can be a sequence, a node of any kind, or a simple value. Examples: xf:string(1) returns the string value "1." xf:string("-91") returns the string value "-91." xf:string(xf:true()) returns the string value "true." xf:string(xf:false()) returns the string value "false." xf:string("abc", "def") generates a compile-time error because the function does not accept two parameters. xf:string(("abc", "def")) generates a compile-time error because the function does not accept a sequence as parameter. xf:string(<a/>) returns an empty string value "". xf:string(<a>abc</a>) returns the string value "abc."	Notes: Liquid Data accepts any simple value, but supports no other accessor types, such as a sequence or other type of node. XQuery Specification Compliance: Liquid Data treats xf:string as both a constructor and an accessor. Liquid Data supports only the string format that requires one node of any type as the input. Liquid Data accepts xsext:anyType input instead of a list of items. Liquid Data returns an optional string. Liquid Data does not recognize entities.

 

 

---

DateTime Functions

DateTime functions extract all or part of a dateTime expression and use it in a query.

xf:add-days

Data Types

• Parameter1 data type: xs:date?

• Parameter2 data type: xs:decimal?

• Returned data type: xs:date?

Description

Adds the number of days specified by Parameter2 to the date specified by Parameter1. The value of Parameter2 may be negative.

Notes

If Parameter1 has a timezone, it remains unchanged. The returned value is always normalized into a correct Gregorian calendar date. If either parameter is an empty list, the function returns an empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:add-days(xf:date("2002-07-15"), -3) returns a date value corresponding to July 12, 2002.

• xf:add-days(xf:date("2002-07-15"), 0) returns a date value corresponding to July 15, 2002.

• xf:add-days(xf:date("2002-07-15"), 2) returns a date value corresponding to July 17, 2002.

• xf:add-days("2002-07-15", 2) generates a compile-time error because the first parameter is a string and not a date value.

xf:current-dateTime

Data Types

No parameters required.

Returned data type: xs:dateTime

Description

Returns the current date and time.

Notes

The function returns the current date and time in the current timezone.

If the function is called multiple times during the execution of a query, it returns the same value each time.

XQuery Specification Compliance

Liquid Data returns the time zone where the Liquid Data Server is running.

Example

xf:current-dateTime() can return a dateTime value such as 2002-07-25T01:00:38.812-08:00, which represents July 25th, 2002 at 1:00:38 and 812 thousandths of a second in a time zone that is offset by -8 hours from GMT (UTC).

xf:date

Data Types

• Input data type: xs:string?

• Returned data type: xs:date?

Description

Returns a date from a source value, which must contain a date in one of these formats:

• YYYY-MM-DD

• YYYY-MM-DDZ

• YYYY-MM-DD+hh:mm

• YYYY-MM-DD-hh:mm

where the following is true:

• YYYY represents the year

• MM represents the month (as a number)

• DD represents the day

• Plus (+) or minus (-) is a positive or negative time zone offset

• hh represents the hours

• mm represents the number minutes that the time zone differs from GMT (UTC)

• Z indicates that the time is in the GMT time zone

Notes

The representation for date is the leftmost representation for dateTime: YYYY-MM-DD+hh:mm with an optional following time zone indicator (Z).

Liquid Data supports this year range: 0000-9999.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:date("2002-07-15") returns a date value corresponding to July 15th, 2002 in the current time zone.

• xf:date("2002-07-15-08:00") returns a date value corresponding to July 15th, 2002 in a timezone that is offset by -8 hours from GMT (UTC).

• xf:date("2002-7-15") generates a runtime error because the month is not specified with two digits.

• xf:date("2002-07-15Z") returns a date value corresponding to July 15th, 2002 in the GMT time zone.

• xf:date("2002-02-31") generates a runtime error because the string (02-31) does not represent a valid date.

xfext:date-from-dateTime

Data Types

• Input data type: xs:dateTime?

• Returned data type: xs:date?

Description

Returns the leftmost date portion of a dateTime value.

Notes

This is an extended function. It has an xfext: prefix identifier (namespace), which is the extension to the standard XQuery function namespace (xf:). For more information about extended functions, see Naming Conventions. For more information about valid formats for dateTime, see xf:dateTime.

XQuery Specification Compliance

Liquid Data supports date-from-dateTime as an extended function.

Examples

• xfext:date-from-dateTime(xf:dateTime("2002-07-15T21:09:44")) returns a date value corresponding to July 15th, 2002 in the current time zone.

• xfext:date-from-dateTime(()) returns an empty list ().

xfext:date-from-string-with-format

Data Types

• Parameter1 data type: xs:string?

• Parameter2 data type: xs:string?

• Returned data type: xs:date?

Description

Returns the right-most date portion of a dateTime value according to the pattern specified by Parameter1. For more information, see Date and Time Patterns.

Notes

This is an extended function. It has an xfext: prefix identifier (namespace), which is the extension to the standard XQuery function namespace (xf:). For more information about extended functions, see Naming Conventions.

XQuery Specification Compliance

Liquid Data supports date-from-string-with-format as an extended function.

Examples

• xfext:date-from-string-with-format("yyyy-MM-dd G", "2002-06-22 AD") returns the specified date in the current time zone.

• xfext:date-from-string-with-format("yyyy-MM-dd", "2002-July-22") generates an error because the date string does not match the specified format.

• xfext:date-from-string-with-format("yyyy-MMM-dd", "2002-July-22") returns the specified date in the current time zone.

xf:dateTime

Data Types

• Input data type: xs:string?

• Returned data type: xs:dateTime?

Description

Returns a dateTime value from a source value, which must contain a date and time in one of these formats:

• YYYY-MM-DDThh:mm:ss

• YYYY-MM-DDThh:mm:ssZ

• YYYY-MM-DDThh:mm:ss+hh:mm

• YYYY-MM-DDThh:mm:ss-hh:mm

where the following is true:

• YYYY represents the year

• MM represents the month (as a number)

• DD represents the day

• T is the date and time separator

• hh represents the number of hours

• mm represents the number of minutes

• ss represents the number of seconds

• Plus (+) or minus (-) is a positive or negative time zone offset

• hh represents the hours

• mm represents the number minutes that the time zone differs from GMT (UTC)

• Z indicates that the time is in the GMT time zone

Notes

Returns a date and time in YYYY-MM-DDT+hh:mm:ss format.

This expression can be preceded by an optional leading minus (-) sign to indicate a negative number. If the sign is omitted, positive (+) is assumed.

Use additional digits to increase the precision of fractional seconds if desired. The format ss.ss... with any number of digits after the decimal point is supported. Fractional seconds are optional.

Liquid Data supports this year range: 0000-9999.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:dateTime("2002-07-15T21:09:44") returns a date value corresponding to July 15th, 2002 at 9:09PM and 44 seconds in the current time zone.

• xf:dateTime("2002-07-15T21:09:44.566") returns a date value corresponding to July 15th, 2002 at 9:09PM and 44.566 seconds in the current time zone

• xf:dateTime("2002-07-15T21:09:44-08:00") returns a date value corresponding to July 15th, 2002 at 9:09PM and 44 seconds, in a time zone that is offset by -8 hours from GMT (UTC).

• xf:dateTime("2002-7-15T21:09:44") generates a runtime error because the month is not specified using two digits

• xf:dateTime("2002-07-15T21:09:44Z") returns a date value corresponding to July 15th, 2002 at 9:09PM and 44 seconds, in the GMT timezone

xfext:dateTime-from-string-with-format

Data Types

• Parameter1 data type: xs:string?

• Parameter2 data type: xs:string?

• Returned data type: xs:dateTime?

Description

Returns a new dateTime value from a string source value according to the pattern specified by Parameter1.

Notes

This is an extended function. It has an xfext: prefix identifier (namespace), which is the extension to the standard XQuery function namespace (xf:).

For more information about extended functions, see Naming Conventions, and see Date and Time Patterns.

XQuery Specification Compliance

Liquid Data supports dateTime-from-string-with-format as an extended function.

Examples

• xfext:dateTime-from-string-with-format("yyyy-MM-dd G", "2002-06-22 AD") returns the specified date, 12:00:00AM in the current time zone.

• xfext:dateTime-from-string-with-format("yyyy-MM-dd 'at' hh:mm", "2002-06-22 at 11:04") returns the specified date, 11:04:00AM in the current time zone.

• xfext:dateTime-from-string-with-format("yyyy-MM-dd", "2002-July-22") generates an error because the date string does not match the specified format.

• xfext:dateTime-from-string-with-format("yyyy-MMM-dd", "2002-July-22") returns 12:00:00AM in the current time zone.

xf:get-hours-from-dateTime

Data Types

• Input data type: xs:dateTime?

• Returned data type: xs:integer?

Description

Returns an integer value representing the hour identified in dateTime.

Notes

The hour value ranges from 0 to 23.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:get-hours-from-dateTime(xf:dateTime("2002-07-15T21:09:44")) returns the integer value 21.

• xf:get-hours-from-dateTime(()) returns an empty list ().

xf:get-hours-from-time

Data Types

• Input data type: xs:time?

• Returned data type: xs:integer?

Description

Returns an integer representing the hour identified in time.

Notes

The hour value ranges from 0 to 23, inclusive.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:get-hours-from-time(xf:time("21:09:44")) returns the integer value 21.

• xf:get-hours-from-time(()) returns an empty list ().

xf:get-minutes-from-dateTime

Data Types

• Input data type: xs:dateTime?

• Returned data type: xs:integer?

Description

Returns an integer value representing the minutes identified in dateTime.

Notes

Returns an integer value representing the minute identified in the source value. The minute value ranges from 0 to 59, inclusive.

If the source value is an empty list, the function returns the empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:get-minutes-from-dateTime(xf:dateTime("2002-07-15T21:09:44")) returns the integer value 9.

• xf:get-minutes-from-dateTime(()) returns an empty list ().

xf:get-minutes-from-time

Data Types

• Input data type: xs:time?

• Returned data type: xs:integer?

Description

Returns an integer value representing the minutes identified in time.

Notes

The minute value ranges from 0 to 59.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:get-minutes-from-time(xf:time("21:09:44")) returns the integer value 9.

• xf:get-minutes-from-time(()) returns an empty list ().

xf:get-seconds-from-dateTime

Data Types

• Input data type: xs:dateTime?

• Returned data type: xs:integer?

Description

Returns an integer value representing the seconds identified in dateTime.

Notes

The seconds value ranges from 0 to 60.999. The precision (number of digits) of fractional seconds depends on the relevant facet of the argument.

The value can be greater than 60 seconds to accommodate occasional leap seconds used to keep human time synchronized with the rotation of the planet.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:get-seconds-from-dateTime(xf:dateTime("2002-07-15T21:09:44")) returns the integer value 44.

• xf:get-seconds-from-dateTime(()) returns an empty list ().

xf:get-seconds-from-time

Data Types:

• Input data type: xs:time?

• Returned data type: xs:integer?

Description

Returns an integer value representing the seconds identified in time.

Notes

The seconds value ranges from 0 to 60.999. The precision (number of digits) of fractional seconds depends on the relevant facet of the argument.

The value can be greater than 60 seconds to accommodate occasional leap seconds used to keep human time synchronized with the rotation of the planet.

If the source value is an empty list, the function returns an empty list.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:get-seconds-from-time(xf:time("21:09:44")) returns the integer value 44.

• xf:get-seconds-from-time(()) returns an empty list ().

xf:time

Data Types

• Input data type: xs:string?

• Returned data type: xs:time?

Description

Returns a tine from a source value, which must contain the time in one of these formats:

• hh:mm:ss

• hh:mm:ssZ

• hh:mm:ss+hh:mm

• hh:mm:ss-hh:mm

where the following is true:

• hh represents the number of hours

• mm represents the number of minutes

• ss represents the number of seconds

• Plus (+) or minus (-) is a positive or negative time zone offset

• hh represents the number of hours that the time zone differs from GMT (UTC)

• mm represents the number of minutes that the time zone differs from GMT (UTC)

• Z indicates that the time is in the GMT time zone

Notes

Liquid Data generates an error if it cannot parse the string successfully.

XQuery Specification Compliance

Conforms to the current specification.

Examples

• xf:time("22:04:22") returns a time value corresponding to 10:04PM and 22 seconds in the current time zone.

• xf:time("22:04:22.343") returns a time value corresponding to 10:04PM and 22.343 seconds, in the current time zone.

• xf:time("22:04:22-08:00") returns a time value corresponding to 10:04PM and 22 seconds in a time zone that is offset by -8 hours from GMT (UTC).

• xf:time("22:4:22") generates a runtime error because the minutes are not specified with two digits.

• xf:time("22:04:22Z") returns a time value corresponding to 10:04PM and 22 seconds in the GMT time zone.

xfext:time-from-dateTime

Data Types

• Input data type: xs:dateTime?

• Returned data type: xs:time?

Description

Returns the time from dateTime.

Notes

This is an extended function. It has an xfext: prefix identifier (namespace), which is the extension to the standard XQuery function namespace (xf:). For more information about extended functions, see Naming Conventions. For more information about valid formats for dateTime, see xf:dateTime.

XQuery Specification Compliance

Liquid Data supports time-from-dateTime as an extended function.

Examples

• xfext:time-from-dateTime(xf:dateTime("2002-07-15T21:09:44")) returns a date value corresponding to 9:09:44PM in the current time zone.

• xfext:time-from-dateTime(()) returns an empty list ().

xfext:time-from-string-with-format

Data Types

• Parameter1 data type: xs:string?

• Parameter2 data type: xs:string?

• Returned data type: xs:time?

Description

Returns a new time value from a string source value according to the pattern specified by Parameter1.

Notes

This is an extended function. It has an xfext: prefix identifier (namespace), which is the extension to the standard XQuery function namespace (xf:).

For more information about extended functions, see Naming Conventions, and see Date and Time Patterns.

XQuery Specification Compliance

Liquid Data supports time-from-string-with-format as an extended function.

Examples

• xfext:time-from-string-with-format("HH.mm.ss", "21.45.22") returns the time 9:45:22PM in the current time zone.

• xfext:time-from-string-with-format("hh:mm:ss a", "8:07:22 PM") returns the time 8:07:22PM in the current time zone.

• xfext:time-from-string-with-format("hh:mm:ss z", "8:07:22 EST") returns the time 8:07:22AM in the EST time zone.

Date and Time Patterns

You can construct date and time patterns using standard Java class symbols. The following table shows the pattern symbols you can use.

Table 7-1 Date and Time Patterns

This Symbol	Represents This Data	Produces This Result
G	Era	AD
y	Year	1996
M	Month of year	July, 07
d	Day of the month	19
h	Hour of the day (1-12)	10
H	Hour of the day (0-23)	22
m	Minute of the hour	30
s	Second of the minute	55
S	Millisecond	978
E	Day of the week	Tuesday
D	Day of the year	27
w	Week in the year	27
W	Week in the month	2
a	am/pm marker	AM, PM
k	Hour of the day (1-24)	24
K	Hour of the day (0-11)	0
z	Time zone	Pacific Standard Time Pacific Daylight Time

 

Repeat each symbol to match the maximum number of characters required to represent the actual value. For example, to represent 4 July 2002, the pattern is d MMMM yyyy. To represent 12:43 PM, the pattern is hh:mm a.

 

---

Node Functions

Node functions are operations on nodes and node values.

Table A-6 Node Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:local-name	Data Types: Input data type: xsext:node Returned data type: xs:string? Description: Returns a string value that corresponds to the local name of the specified node. Examples: xf:local-name(<db:homes/>) returns the string value "homes." xf:local-name(73) generates a compile-time error because the parameter is a number and not a node.	XQuery Specification Compliance: Liquid Data does not support the format that accepts no input parameters. Liquid Data supports an optional string as the returned value instead of a required string.

 

 

---

Numeric Functions

Numeric functions operate on numeric data types.

Table A-7 Numeric Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xf:ceiling	Data Types: Input data type: xs:double? Returned data type: xs:integer? Description: Returns the smallest (closest to negative infinity) integer that is not smaller than the source value. Examples: xf:ceiling(38.3) returns the integer value 39. xf:ceiling(38) returns the integer value 38. xf:ceiling(-3.3) returns the integer value -3. xf:ceiling("38.3") generates a compile-time error because the parameter is a string and not a numeric value.	Notes: If the argument is an empty list, the function returns an empty list. XQuery Specification Compliance: Conforms to the current specification.
xf:floor	Data Types: Input data type: xs:double? Returned data type: xs:integer? Description: Returns the largest (closest to positive infinity) integer that is not greater than the source value. Examples: xf:floor(38.3) returns the integer value 38. xf:floor(38) returns the integer value 38. xf:floor(-3.3) returns the integer value -4. xf:floor("38.3") generates a compile-time error because the parameter is a string and not a numeric value.	Notes: If the argument is an empty list, the function returns an empty list. XQuery Specification Compliance: Conforms to the current specification.
xf:round	Data Types: Input data type: xs:double? Returned data type: xs:integer? Description: Returns the integer that is closest to the source value. Examples: xf:round(3) returns the integer value 3. xf:round(3.3) returns the integer value 3. xf:round(3.5) returns the integer value 4. xf:round(3.7) returns the integer value 4. xf:round(-3.3) returns the integer value -3. xf:round(-3.5) returns the integer value -3. xf:round(-3.7) returns the integer value -4. xf:round(-0) returns the integer value 0. xf:round("3.3") generates an error because the parameter is a string and not a numeric value.	Notes: Round(x) produces the same result as the Floor function(x+0.5). If there are two such numbers, returns the one that is closest to +INF. If the argument is +INF, returns +INF. If the argument is -INF, returns -INF. If the argument is +0, returns +0. If the source value is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN) or -0.

 

 

---

Comparison and Numeric Operators

XQuery has operators that are specific to types of operations, such as comparisons or numeric operations.

Table A-8 Comparison and Numeric Operators

Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
* (Multiply)	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the arithmetic product of the operands: ($operand1*$operand2). Examples: 12 * 3 returns the decimal value 36. xf:integer("1") * 3.1 returns the decimal value 3.1. "abc" * "cde" generates a compile-time error because the operator can be used only with numbers.	Notes: This is a numeric operator that you can use as if it were a function to compute numeric results. The operator accepts two numeric values as parameters, computes their product, and returns the result. Liquid Data applies the following rules: If both parameters are promotable to xs:decimal, the operator returns their product as a decimal value. If both parameters are promotable to xs:float, the operator returns their product as a floating point value. If both parameters are promotable to xs:double, the operator returns their product as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data supports only numeric multiplication (op:numeric-multiply) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration. Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.
+ (Add)	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the arithmetic sum of the operands: ($operand1+$operand2). Examples: 20 + 1 returns the decimal value 21. xf:integer("1") + 3.1 returns the decimal value 4.1. "abc" + "cde" generates a compile-time error because the operator can only be used with numbers.	Notes: This is a numeric operator that you can use as if it were a function to compute numeric results. The operator accepts two numeric values as parameters, computes their sum, and returns the result. Liquid Data applies the following rules: If both parameters are promotable to xs:decimal, the operator returns their sum as a decimal value. If both parameters are promotable to xs:float, the operator returns their sum as a floating point value. If both parameters are promotable to xs:double, the operator returns their sum as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data supports only numeric multiplication (op:numeric-add) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration. Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.
-(Subtract)	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the arithmetic difference of the operands: ($operand1-$operand2). Examples: 20 - 1 returns the decimal value 19. xf:integer("1") - 3.1 returns the decimal value -2.1. "abc" - "cde" generates a compile-time error because the operator can only be used with numbers.	Notes: This is a numeric operator that you can use as if it were a function to compute numeric results. Liquid Data applies the following rules: If both parameters are promotable to xs:decimal, the operator returns their difference as a decimal value. If both parameters are promotable to xs:float, the operator returns their difference as a floating point value. If both parameters are promotable to xs:double, the operator returns their difference as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data supports only numeric multiplication (op:numeric-subtract) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration. Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.
and	Data Types: Parameter1 data type: xs:boolean? Parameter2 data type: xs:boolean? Returned data type: xs:boolean? Description: The result is true if both values are true, and false if one of the values is false. Examples: xf:true() and xf:true() returns the boolean value true. xf:true() and xf:false() returns the boolean value false. xf:false() and xf:false() returns the boolean value false. xf:true() and (<a/>, <b/>) generates a compile-time error because lists are not supported as input parameters to boolean operators. xf:false() and "false" generates a compile-time error because the second parameter is not a boolean value.	Notes: This is a boolean operator that you can use as a function to return a true or false result. The arguments and return type are all boolean. The following table shows how Liquid Data determines the result. The leftmost column contains the possible values of the first parameter; the top row contains the possible values of the second parameter.   XQuery Specification Compliance: Liquid Data does not support error values. Liquid Data does not support a list of nodes as an input parameter to a boolean operator.
div(ide)	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the arithmetic quotient of the operands ($operand1/$operand2). Examples: 2 div 5 returns the decimal value 0. 3 div 5 returns the decimal value 1. 4 div "abc" generates a compile-time error because the operator can only be used with numbers.	Notes: This is a numeric operator that you can use as if it were a function to compute numeric results. Liquid Data applies the following rules: If both parameters are promotable to xs:decimal, the operator returns their quotient as a decimal value. If both parameters are promotable to xs:float, the operator returns their quotient as a floating point value. If both parameters are promotable to xs:double, the operator returns their quotient as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data supports only numeric multiplication (op:numeric-divide) and no other backup functions. It does not support values, such as xs:yearMonthDuration and xs:dayTimeDuration. Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.
eq	Data Types: Parameter1 data type: xsext:anyValue? Parameter2 data type: xsext:anyValue? Returned data type: xs:boolean? Description: Returns true if Parameter1 is exactly equal to Parameter2. Examples: 45 eq 45.0 returns the boolean value true. 170 eq 34 returns the boolean value false. 3 eq "3" generates an error because the decimal value 3 cannot be promoted to the string value "3." 1 eq xf:true() generates an error because the decimal value 1 cannot be promoted to the boolean value true. "abc" eq "abc" returns the boolean value true. (1, ()) eq 1 evaluates to the boolean value true because there is exactly one value in the leftmost list and that value is equal to the rightmost value. (1, 2) eq 1 generates a compile-time error because the operator does not evaluate lists.	Notes: This is a comparison operator that you can use as a function to compare operands. If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error. If either operand is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not cast xs:anySimpleType to any other supported type. Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.
ge	Data Types: Parameter1 data type: xsext:anyValue? Parameter2 data type: xsext:anyValue? Returned data type: xs:boolean? Description: Returns true if Parameter1 is greater than or equal to Parameter2. Examples: See the examples for "eq" operator (previous entry in this table).	Notes: This is a comparison operator that you can use as a function to compare operands. If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error. If either operand is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not cast xs:anySimpleType to any other supported type. Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.
gt	Data Types: Parameter1 data type: xsext:anyValue? Parameter2 data type: xsext:anyValue? Returned data type: xs:boolean? Description: Returns true if Parameter1 is greater than Parameter2. Examples: See the examples for the "eq" operator (previous entry in this table).	Notes: This is a comparison operator that you can use as a function to compare operands. If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error. If either operand is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not cast xs:anySimpleType to any other supported type. Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.
le	Data Types: Parameter1 data type: xsext:anyValue? Parameter2 data type: xsext:anyValue? Returned data type: xs:boolean? Description: Returns true if Parameter1 is less than or equal to Parameter2. Examples: See the examples for the "eq" operator (previous entry in this table).	Notes: This is a comparison operator that you can use as a function to compare operands. If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error. If either operand is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not cast xs:anySimpleType to any other supported type. Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.
lt	Data Types: Parameter1 data type: xsext:anyValue? Parameter2 data type: xsext:anyValue? Returned data type: xs:boolean? Description: Returns true if Parameter1 is less than or equal to Parameter2. Examples: See the examples for the "eq" operator (previous entry in this table).	Notes: This is a comparison operator that you can use as a function to compare operands. If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error. If either operand is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not cast xs:anySimpleType to any other supported type. Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.
mod	Data Types: Parameter1 data type: xs:anyValue? Parameter2 data type: xs:anyValue? Returned data type: xs:anyValue? Description: Returns the remainder after dividing the first operand by the second operand: ($operand1 mod $operand2). Examples: 2 mod 5 returns the decimal value 2. 3 mod 5 returns the decimal value -2. 4 mod "abc" generates a compile-time error because the operator can only be used with numbers.	Notes: This is a numeric operator that you can use as if it were a function to compute numeric results. Liquid Data applies the following rules: If both parameters are promotable to xs:decimal, the operator returns the remainder as a decimal value. If both parameters are promotable to xs:float, the operator returns the remainder as a floating point value. If both parameters are promotable to xs:double, the operator returns the remainder as a double precision value. Otherwise, an error occurs because one of the parameters is not a number. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF.
ne	Data Types: Parameter1 data type: xsext:boolean? Parameter2 data type: xsext:boolean? Returned data type: xs:boolean? Description: The result is false if both values are false and true if at least one of the values is true. Parameter2 is not evaluated if Parameter1 evaluates to true. Examples: See the examples for the "eq" operator (previous entry in this table).	Notes: This is a boolean operator that you can use as a function to return a true or false result. It is not a standard XQuery operator, but necessary to complete certain comparative expressions in Liquid Data. The arguments and return type are all boolean. If either operand is a node, Liquid Data extracts its typed value first, then performs a type check to ensure that the type of one operand is promotable to the other type; otherwise Liquid Data generates an error. If either operand is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not support these data types: xs:yearMonthDuration, xs:dayTimeDuration, gregorian, xs:hexBinary, xs:base64Binary, xs:anyURI, xs:QName, or xs:NOTATION values.
or	Data Types: Parameter1 data type: xs:boolean? Parameter2 data type: xs:boolean? Returned data type: xs:boolean? Description: The result is false if both values are false and true if at least one of the values is true. Parameter2 is not evaluated if Parameter1 is true. Examples: xf:true() or xf:true() returns the boolean value true. xf:true() or xf:false() returns the boolean value true. xf:false() or xf:false() returns the boolean value false. xf:true() or (<a/>, <b/>) generates a compile-time error because lists are not supported as parameters to boolean operators. xf:false() or "false" generates a compile-time error because the second parameter is not a boolean value.	Notes: This is a boolean operator that you can use as a function to return a true or false result. The arguments and return type are all boolean. The following table shows how Liquid Data determines the result. The leftmost column contains the possible values of the first parameter; the top row contains the possible values of the second parameter XQuery Specification Compliance: Liquid Data does not support error values. Liquid Data does not support a list of nodes as an input parameter to a boolean operator.

 

 

---

Other Functions

Table A-9 Other Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xfext:if-then-else	Data Types: Parameter1 data type: xs:boolean? Parameter2 data type: xs:anyValue? Parameter3 data type: xs:anyValue? Returned data type: xs:anyValue Description: The xfext:if-then-else function accepts the value of a boolean parameter to select one of two other input parameters. Examples: If (xf:true()) then 3 else "10" returns the value 3. If (xf:false()) then 3 else "10" returns the value "10." If ("true") then 3 else "10" generates a compile-time error because the condition is a string value and not a boolean value.	Notes: The If-then-else function is an extended function. For more information about extended functions, see Naming Conventions. Liquid Data examines the value of the first parameter. If the condition is true, Liquid Data returns the value of the second parameter (then). If the condition is false, Liquid Data returns the value of the third parameter (else). If the returned condition is not a boolean value, Liquid Data generates an error. XQuery Specification Compliance: This is an extended function. Liquid Data converts it to an XQuery if-then-else expression.

 

 

---

Sequence Functions

A sequence is an ordered collection of zero or more items. An item may be a node or a simple typed value. Therefore, a sequence can be an ordered collection of nodes, a collection of simple typed values, or any mix of nodes and simple typed values. Sequences may not contain other sequences but may contain duplicate items. There is no difference between a single item, such as a node or a simple typed value, and a sequence containing that single item.

Table A-10 Sequence Functions

Data Type, Description, and Examples	Notes and XQuery Specification Compliance
Function: xf:distinct-values
Data Types: Input data type: xsext:item* Returned data type: xsext:anyValue* Description: If the source value contains only nodes, the function removes duplicates and returns a subset of unique values. Examples: xf:distinct-values(("a", "b", "c", "b")) returns the string sequence ("a", "b", "c"). xf:distinct-values((<x>a</x>, <x>b</x>, <x>c</x>, <x>b</x>)) returns the string sequence (<x>a</x>, <x>b</x>, <x>c</x>). xf:distinct-values(("a", <x>b</x>, <x>c</x>, "b")) generates a compile-time error because the list contains mixed nodes and values.	Notes: The Liquid Data xf:distinct-values function varies from the standard XQuery function by removing duplicates from the result. If the source value is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not support the distinct-values format that accepts collations. Liquid Data uses the eq operator instead of xf:deep-equal to identify duplicates. Liquid Data does not support duration values.
Function: xf:empty
Data Types: Input data type: xsext:item* Returned data type: xs:boolean? Description: Returns true if the specified list of items is empty; otherwise, returns false. Examples: xf:empty((1, 2, 3)) returns the boolean value false. xf:empty(1) returns the boolean value false. xf:empty(()) returns the boolean value true.	XQuery Specification Compliance: Liquid Data supports an optional boolean returned value.
Function: xfext:subsequence
Format  1 Data Types: Parameter1 data type: xsext:item* Parameter2 data type: xs:integer Returned data type: xsext:item* Format  2 Data Types: Parameter1 data type: xsext:item* Parameter2 data type: xs:integer Parameter3 data type: xs:integer Returned data type: xsext:item* Description: Format 1: Returns the contiguous sequence of items described by Parameter 1 beginning at the position indicated by the Parameter 2 and continuing until the end of the sequence. Format 2: Returns the contiguous sequence of items described by Parameter 1 beginning at the position indicated by the Parameter 2 and continuing for the number of items indicated by the value of Parameter 3. Examples: xf:subsequence(("a", "b", "c", "d", "e"), 2) returns the sequence ("b", "c", "d", "e"). xf:subsequence("abcde", 2) returns the string value "bcde." xf:subsequence("abcde", 6) returns the empty string "". xf:subsequence("abcde", 2, 3) returns the string value "bcd." xf:subsequence("abcde", 2, 10) returns the string value "bcde." xf:subsequence("abcde", ()) returns an empty list ().	Notes: Format 1: The first item of a sequence is located at position 1, not position 0. If you omit the length parameter, the function returns all items up to the end of the source sequence. If the starting location is greater than the number of items in the sequence, the function returns an empty list. If the item list is empty, Liquid Data returns an empty list. Format 2: The value of Parameter 2 can be greater than the number of items in the value of Parameter  1, in which case the subsequence includes items to the end of Parameter 3. If the sum of the starting location and the length parameter is greater than the length of the source sequence, the function returns all items up to the end of the sequence. The first item of a sequence is located at position 1, not position 0. If the starting location is greater than the number of items in the sequence, the function returns an empty list. If the item list is an empty list, Liquid Data returns an empty list. Liquid Data is able to process either format of xf:subsequence. Adding a third parameter automatically invokes Format 2. XQuery Specification Compliance: Liquid Data supports xs:integer instead of xs:decimal as the starting location and length parameters. If the starting location is greater than the length of the input sequence, Liquid Data returns an empty list instead of generating an error.

 

String Functions

Strings from a character set may need to be sorted differently for different applications. You must consider the sort order when you invoke string comparisons. Some string functions will require understanding of the default sort order and any other special collation. For more information, see the Character Model for the World Wide Web 1.0.

Table A-11 String Functions

Data Type, Description, and Examples	Notes and XQuery Specification Compliance
Function: xf:compare
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:integer? Description: Returns -1, 0, or 1, depending on whether the value of Parameter1 is less than (-1), equal to (0), or greater than (1)the value of Parameter2. Examples: xf:compare("a", "b") returns the integer value -1. xf:compare("a", "a") returns the integer value 0. xf:compare("b", "a") returns the integer value 1. xf:compare("a", 3) generates a compile-time error because the second parameter is not a string. xf:compare("a", ()) returns an empty list (). xf:compare((), "a") returns an empty list ().	Notes: If either argument is an empty list, the result is an empty list. Liquid Data generates an error if either parameter is not a string. XQuery Specification Compliance: Liquid Data does not support the xf:compare format that accepts collations.
Function: xf:concat
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:string? Description: Returns a string that concatenates Parameter1 with Parameter2. Examples: xf:concat("a", "b") returns the string value "ab." xf:concat("a", xf:concat("b", "c")) returns the string value "abc." xf:concat("abc", ()) returns the string value "abc." xf:concat((), "abc") returns the string value "abc." xf:concat((), ()) returns an empty list (). xf:concat("a", 4) generates a compile-time error because the second parameter is not a string.	Notes: The result string may not reflect Unicode or other W3C normalization. Returns an empty string if the function has no arguments. If any argument is an empty list, it is treated as an empty string. Liquid Data generates an error if either parameter is not a string. XQuery Specification Compliance: Liquid Data does not support a variable number of parameters to be concatenated. Choose only two strings to concatenate with each operation.
Function: xf:contains
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:boolean? Description: Returns a boolean value of true or false indicating whether Parameter1 contains a string that is equal to Parameter2 at the beginning, at the end, or anywhere within Parameter1. Examples: xf:contains("abc", "a") returns the boolean value true. xf:contains("abc", "b") returns the boolean value true. xf:contains("abc", "c") returns the boolean value true. xf:contains("abc", "d") returns the boolean value false. xf:contains("abc", "") returns the boolean value true. xf:contains("abc", ()) returns an empty list (). xf:contains((), "abc") returns an empty list (). xf:contains("abc", 4) generates a compile-time error because the second parameter is not a string.	Notes: If the value of Parameter2 is a zero-length string, the function returns true. If the value of Parameter1 is a zero-length string and the value of Parameter2 is not a zero-length string, the function returns false. If the value of Parameter1 or Parameter2 is an empty list, the function returns an empty list. Liquid Data generates an error if either parameter is not a string. XQuery Specification Compliance: Liquid Data does not support the xf:contains format that accepts collations.
Function: xf:ends-with
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:boolean? Description: Returns a boolean value or true or false indicating whether Parameter1 ends with a string that is equal to Parameter2. Examples: xf:ends-with("abc", "a") returns the boolean value false. xf:ends-with("abc", "b") returns the boolean value false. xf:ends-with("abc", "c") returns the boolean value true. xf:ends-with("abc", "d") returns the boolean value false. xf:ends-with("abc", "") returns the boolean value true. xf:ends-with("abc", ()) returns an empty list (). xf:ends-with((), "abc") returns an empty list (). xf:ends-with("abc", 4) generates a compile-time error because the second parameter is not a string.	Notes: If Parameter2 is a zero-length string, then the function returns true. If Parameter1 is a zero-length string and Parameter2 is not a zero-length string, the function returns false. If Parameter1 or Parameter2 is an empty list, the function returns an empty list. Liquid Data generates an error if either parameter is not a string. XQuery Specification Compliance: Liquid Data does not support the xf:ends-with format that accepts collations.
Function: xf:lower-case
Data Types: Input data type: xs:string? Returned data type: xs:string? Description: Returns the value of the input string after translating every uppercase letter to its corresponding lower-case value. Examples: xf:lower-case("ABc!D") returns the string value "abc!d." xf:lower-case("") returns the empty string "". xf:lower-case(()) returns the empty list (). xf:lower-case(4) generates a compile-time error because the parameter is not a string.	Notes: Every uppercase letter that does not have a lower-case corresponding value and every character that is not an uppercase letter appears in the output in its original form. If the source value is an empty list, the function returns an empty list. XQuery Specification Compliance: Conforms to the current specification.
Function: xf:starts-with
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:boolean? Description: Returns a boolean value or true or false indicating whether Parameter1 starts with a string that is equal to Parameter2. Examples: xf:starts-with("abc", "a") returns the boolean value true. xf:starts-with("abc", "b") returns the boolean value false. xf:starts-with("abc", "c") returns the boolean value false. xf:starts-with("abc", "d") returns the boolean value false. xf:starts-with("abc", "") returns the boolean value true. xf:starts-with("abc", ()) returns the empty list (). xf:starts-with((), "abc") returns the empty list (). xf:starts-with("abc", 4) generates a compile-time error because the second parameter is not a string.	Notes: If Parameter2 is a zero-length string, then the function returns true. If Parameter1 is a zero-length string and tParameter2 is not a zero-length string, the function returns false. If Parameter1 or Parameter2 is an empty list, the function returns an empty list. Liquid Data generates an error if either parameter is not a string. XQuery Specification Compliance: Liquid Data does not support the xf:ends-with format that accepts collations.
Function: xf:string-length
Data Types: Input data type: xs:string? Returned data type: xs:integer? Description: Returns an integer equal to the number of characters in the input source string. Examples: xf:string-length("abc") returns the integer value 3. xf:string-length("") returns the integer value 0. xf:string-length(()) returns the empty list (). xf:string-length(4) generates a compile-time error because the parameter is not a string.	Notes: If the source value is an empty list, the function returns an empty list. Liquid Data generates an error if either parameter is not a string. XQuery Specification Compliance: Liquid Data treats xf:string as both a constructor and an accessor. Liquid Data supports only the string format that requires one node of any type as the input. Liquid Data accepts xsext:anyType input instead of a list of items. Liquid Data returns an optional string. Liquid Data does not recognize entities.
Function: xf:substring
Format 1 Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:integer? Returned data type: xs:string? Format 2 Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:integer? Parameter3 data type: xs:integer? Returned data type: xs:string? Description: Format 1: Returns that part of the Parameter1 source string from the starting location specified by Parameter2. Format 2: Returns that part of the Parameter1 source string from the starting location specified by Parameter2 and continuing for the number of characters equal to the length specified by Parameter3.	Notes: Format 1 If the starting location is a negative value, or greater than the length of source string, an error occurs. The first character of a string is located at position 1 (not position 0). If Parameter1 or Parameter2 is an empty list, the function returns an empty list. If you omit Parameter3, the function returns characters up to the end of the source string. Liquid Data generates an error if Parameter1 is not a string or if the starting location is less than 1. Format 2 If the starting location is a negative value, or greater than the length of the source string, an error occurs. The first character of a string is located at position 1 (not position 0). If you omit length, the substring identifies characters to the end of the source string. If length exceeds the number of characters in the source string, the function identifies only characters until the end of the source string. If Parameter1, Parameter2, or Parameter3 is an empty list, the function returns an empty list. Liquid Data generates an error if Parameter1 is not a string or if the starting location is less than 1. Liquid Data is able to process either format of xf:substring. Adding a third parameter automatically invokes Format 2. XQuery Specification Compliance: Liquid Data supports xs:integer instead of xs:decimal as the starting location and length parameters. If the starting location is greater than the length of the input sequence, Liquid Data returns an empty list instead of generating an error.
Function: xf:substring-after
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:string? Description: Returns that part of the Parameter1 source string that follows the first occurrence of those characters specified in Parameter2. Examples: xf:substring-after("abcde", "d") returns the string value "e." xf:substring-after("abcde", "") returns the string value "abcde." xf:substring-after("abcde", "x") returns the empty string "". xf:substring-after("abcde", ()) returns the empty list (). xf:substring-after((), "x") returns the empty list (). xf:substring-after("abc34de", 3) generates a compile-time error because the second parameter is not a string.	Notes: If Parameter2 is a zero-length string, the function returns the value of Parameter1. If Parameter1 is a zero-length string and Parameter2 is a zero-length string, the function returns a zero-length string. If Parameter1 does not contain a string that is equal to Parameter2, the function returns a zero-length string. If Parameter1 or Parameter2 is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not support the xf:substring-after format that accepts collations.
Function: xf:substring-before
Data Types: Parameter1 data type: xs:string? Parameter2 data type: xs:string? Returned data type: xs:string? Description: Returns that part of the Parameter1 source string that precedes the first occurrence of those characters specified in Parameter2. Examples: xf:substring-before("abcde", "d") returns the string value "abc." xf:substring-before("abcde", "") returns the string value "abcde." xf:substring-after("abcde", "x") returns the empty string "". xf:substring-before("abcde", ()) returns an empty list (). xf:substring-before((), "x") returns an empty list (). xf:substring-before("abc34de", 3) generates a compile-time error because the second parameter is not a string.	Notes: If Parameter2 is a zero-length string, the function returns the value of Parameter1. If Parameter1 is a zero-length string and Parameter2 is a zero-length string, the function returns a zero-length string. If Parameter1 does not contain a string that is equal to Parameter2, the function returns a zero-length string. If Parameter1 or Parameter2 is an empty list, the function returns an empty list. XQuery Specification Compliance: Liquid Data does not support the xf:substring-before format that accepts collations.
Function: xf:extrim
Data Types: Input data type: xs:string? Returned data type: xs:string? Description: Returns the value of the input string with leading and trailing white space removed from the string. Examples: xfext:trim("abc") returns the string value "abc." xfext:trim(" abc ") returns the string value "abc." xfext:trim(()) returns the empty list (). xfext:trim(5) generates a compile-time error because the parameter is not a string.	Notes: If the input string is an empty list, the function returns an empty list. Liquid Data generates an error if the parameter is not a string. XQuery Specification Compliance: The xfext:trim function is an extended function. For more information about extended functions, see Naming Conventions.
Function: xf:upper-case
Data Types: Input Parameter data type = xs:string? Returned data type: xs:string? Description: Returns the value of the input string after translating every lower-case letter to its uppercase correspondent.	Notes: Every lower-case letter that does not have an uppercase corresponding value and every character that is not a lower-case letter appears in the output in its original form. If the source value is an empty list, the function returns an empty list. Liquid Data generates an error if the parameter is not a string. XQuery Specification Compliance: Conforms to the current specification. Examples: xf:upper-case("ABc!D") returns the string value "ABC!D." xf:upper-case("") returns the empty string "". xf:upper-case(()) returns the empty list (). xf:upper-case(4) generates a compile-time error because the parameter is not a string.

 

 

---

Type Casting Functions

Type cast functions process a source value as the argument. Type casting will typically fail if applied to more than one element. An empty list is allowed, but the result of the type casting will consist of an empty list. Type casting functions are more likely to generate exceptions at run time if the parameter cannot be converted to the corresponding type.

The following table describes Liquid Data data types that conform to the XQuery specification that you can use in type casting functions. For more information about data types, see the XQuery 1.0 and XPath 2.0 Functions and Operators specification.

Table A-12 Type Casting Functions

Function Name	Data Type, Description, and Examples	Notes and XQuery Specification Compliance
xs:boolean	Data Types: Input data type: xs:anyValue Returned data type: xs:boolean Description: Converts the input to a boolean value (true or false). If the input parameter is empty, the function returns an empty list. Otherwise, Liquid Data generates an error. Examples: Cast as xs:boolean ("true") returns the boolean value true. Cast as xs:boolean ("FalSE") returns the boolean value false. Cast as xs:boolean (0) generates a runtime error because the value cannot be cast to a boolean value. Cast as xs:boolean (1) generates a runtime error because the value cannot be cast to a boolean value. Cast as xs:boolean (()) returns an empty list ().	Notes: This function uses the xf:boolean-from-string function. XQuery Specification Compliance: Conforms to the current specification; however, Liquid Data does not accept the values "1" and "0" to represent true and false, as described in the W3C XML Schem document.
xs:date	Data Types: Input data type: xs:anyValue Returned data type: xs:date Description: Converts the input to a date value. Examples: Cast as xs:date ("2002-07-23") returns the date July 23rd, 2002. Cast as xs:date ("2002-07") generates a runtime error because the value cannot be converted to a date.	Notes: This function uses the xf:date function. The string must contain a date in one of these formats: YYY-MM-DD YYYY-MM-DDZ YYYY-MM-DD-hh:mm where YYYY represents the year, MM represents the month (as a number), DD represents the day, hh and mm represents the number of hours and minutes that the timezone differs from GMT (UTC). Z indicates that the date is in the GMT timezone. If the string cannot be parsed into a date value, Liquid Data generates an error. XQuery Specification Compliance: Conforms to the current specification.
xs:dateTime	Data Types: Input data type: xs:anyValue Returned data type: xs:dateTime Description: Converts the input to a dateTime value. Examples: Cast as xs:dateTime ("2002-07-23T23:04:44") returns the dateTime value July 23rd, 2002 at 11:04:44 PM in the local timezone. Cast as xs:dateTime ("2002-07-23T23:04:44-08:00") returns the dateTime value July 23rd, 2002 at 11:04:44 PM in the a timezone that is offset by -8 hours from GMT (UTC). Cast as xs:date ("2002-07-23") generates a runtime error because no time value is specified.	Notes: This function uses the xf:date function. XQuery Specification Compliance: Conforms to the current specification.
xs:decimal	Data Types: Input data type: xs:anyValue Returned data type: xs:decimal Description: Converts the input to a decimal value. Examples: Cast as xs:decimal ("213") returns the decimal value 213. Cast as xs:decimal ("-100") returns the decimal value -100. Cast as xs:decimal (0) returns the decimal value 0.	Notes: This function uses the xf:decimal function. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time. Liquid Data supports "e" and "E" to construct floating point integer values.
xs:double	Data Types: Input data type: xs:anyValue Returned data type: xs:double Description: Converts the input to a double precision value. Examples: Cast as xs:double ("21") returns the double precision value 21.0. Cast as xs:double ("-3e3") returns the double precision value -3000.0. Cast as xs:double (0) returns the double precision value 0.0. Cast as xs:double ("abc) generates a runtime error because the string cannot be converted to a double precision value.	Notes: This function uses the xf:double function. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xs:float	Data Types: Input data type: xs:anyValue Returned data type: xs:float Description: Converts the input to a floating point value. Examples: Cast as xs:float ("21") returns the floating point value 21.0. Cast as xs:float ("-3e3") returns the floating point value -3000.0. Cast as xs:float (0) returns the floating point value 0.0. Cast as xs:float ("abc) generates a runtime error because the string cannot be converted to a floating point value.	Notes: This function uses the xf:float function. XQuery Specification Compliance: Liquid Data does not support not-a-number (NaN), -0, or the negative and positive infinity values -INF and INF. Liquid Data attempts to support any input value, instead of just string literals, and convert it at run time.
xs:string	Data Types: Input data type: xs:anyType Returned data type: xs:string Description: Converts the input to a string value. Examples: Cast as xs:string ("abc") returns the string value "abc." Cast as xs:string (21) returns the string value "21." Cast as xs:string (xf:true()) returns the string value "true." Cast as xs:string (xf:false()) returns the string value "false."	Notes: This function uses the xf:string function. XQuery Specification Compliance: Liquid Data treats xf:string as both a constructor and an accessor. Liquid Data supports only the string format that requires one node of any type as the input. Liquid Data accepts xsext:anyType input instead of a list of items. Liquid Data returns an optional string. Liquid Data does not recognize entities.
xs:time	Data Types: Input data type: xs:anyValue Returned data type: xs:time Description: Converts the input to a time value. Examples: Cast as xs:time ("09:35:20") returns the time value 9:35:20 AM in the current timezone. Cast as xs:time (<a>09:35:20</a>) returns the time value 9:35:20 AM in the current timezone. Cast as xs:time ("9:35:20") generates a runtime error because the time format is incorrect (hour specified with 1 digit instead of 2) and therefore the string cannot be converted to a time value. Cast as xs:time ("21:35:20-08:00") returns the time value 9:35:20 PM in the a timezone that is offset by -8 hours from GMT (UTC).	Notes: This function uses the xf:time function. XQuery Specification Compliance: Conforms to the current specification.