XQuery Reference Guide
|
 |
 |
|
|
 |
 |
The World Wide Web (W3C) specification for XQuery supports a discrete set of functions. BEA Liquid Data for WebLogic 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.
For more information on the functions described here, see also:
This section provides a complete reference of the W3C functions Liquid Data supports, as well as any extended functions Liquid Data supports. This functions reference is organized by category as follows:
You can browse the Liquid Data XQuery functions in the Data View Builder. The functions are located in the Design tab —> Toolbox tab —> XQuery Functions. You can also make your own custom functions. This section describes the conventions used in the Liquid Data XQuery functions and describes the XQuery data types.
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.
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.
These occurrence indicators also communicate information about the data type when they appear in a function signature. For example:
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.
You can construct date and time patterns using standard Java class symbols. The following table shows the pattern symbols you can use.
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.
Accessor and node functions operate on different types of nodes and node values. They accept single node input and return a value based on the node type. These function are not available in the XQuery functions section of the Data View Builder, but the Data View Builder will, in some circumstances, generate queries that use these functions. The functions available are:
Returns the typed-value of each input node. This function is not available in the XQuery functions section of the Data View Builder.
The xf:data function is available to Liquid Data, but you cannot explicitly map a node in the Data View Builder, so you therefore cannot construct a query in the Data View Builder that uses the xf:data function. In some cases, however, the Data View Builder will implicitly generate queries that use the xf:data function. The typical case when the Data View Builder generates the xf:data function is when it does not know the name of the elements at query generation time, and it uses the xf:data function in a variable expression containing wildcard characters.
If the source value is not a node, the function returns an error.
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.Returns the specified document. This function is not available in the XQuery functions section of the Data View Builder.
The input of this version of the xf:document function is the logical name of a Liquid Data data source.
Use the xf:document function to specify an XML document. Because Liquid Data models data sources as XML documents, the XML document specified can represent a relational database, an XML file, or other data sources registered in the Liquid Data Administration Console. The xf:document function is available to Liquid Data, but you cannot explicitly map a node in the Data View Builder. In many cases, however, the Data View Builder implicitly generates queries that use the xf:document function.
xf:document("My_Relational_DS")
Returns the specified document for the given dynamic data source. This function is not available in the XQuery functions section of the Data View Builder.
This version of the xf:document function is used with dynamic XML and delimited file data sources (a dynamic data source is a data source in which the data file is specified at query runtime). For the first input, specify the logical name of a Liquid Data data source. For the second input, specify a URL or file (absolute path or relative to the Liquid Data Repository for the type of data source).
Use the xf:document function to specify an XML document. Because Liquid Data models data sources as XML document, the XML document specified can represent a relational database, an XML file, or other data sources registered in the Liquid Data Administration Console. The xf:document function is available to Liquid Data, but you cannot explicitly map a node in the Data View Builder. In many cases, however, the Data View Builder implicitly generates queries that use the xf:document function.
xf:document("My_XML_DS", "c:\myFolder\file.xml")
Returns a string value that corresponds to the local name of the specified node. This function is not available in the XQuery functions section of the Data View Builder.
The xf:local-name function is available to Liquid Data, but you cannot explicitly map a node in the Data View Builder, so you therefore cannot construct a query in the Data View Builder that uses the xf:local-name function. In some cases, however, the Data View Builder will implicitly generate queries that use the xf:local-name function. The typical case when the Data View Builder generates the xf:local-name function is when it does not know the name of the elements at query generation time, and it uses the xf:local-name function in a variable expression containing wildcard characters.
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.
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. The following aggregate functions are available:
Returns the average of a sequence of numbers.
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.
Liquid Data requires a list of double precision values instead of a list of items.
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.Returns the number of items in the sequence in an unsigned integer.
If the source value is an empty list, the function returns an empty list.
Liquid Data returns an integer value (xs:integer) instead of an unsigned int (xs:unsignedInt) value.
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). 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.
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:
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:
Both of these conditions must be true; otherwise, the function returns an error.
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.
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:
Both of these conditions must be true; otherwise, the function returns an error.
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 ().Returns the sum of a sequence of numbers.
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.
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.
Boolean functions return true (1) or false(0) values. The following boolean functions are available:
Returns the boolean value false.
Conforms to the current specification.
xf:false() returns false. xf:false(34) generates a compile-time error because the function does not accept any parameters.Returns true if the value of the source value is false and false if the value of the source value is true.
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.Returns the boolean value true.
Conforms to the current specification.
xf:true() returns true.xf:true("34") generates a compile-time error because the function does not accept any parameters.
Cast functions process a source value as the argument and type cast the output to a different datatype. 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. The following cast functions are available:
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.
This function uses the xf:boolean-from-string function.
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.
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 ().Converts the input to a byte value.
This function uses the xf:byte function.
This function will complete sucessfully only if the value cast is a numeric value greater than -128 or less than 128; all other values will fail.
Conforms to the current specification.
cast as xs:byte(22) returns the byte value of 22.cast as xs:byte(22.9334) returns the byte value 22.Converts the input to a date value.
This function uses the xf:date function.
The string must contain a date in one of these formats:
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.
Conforms to the current specification.
cast as xs:date ("2002-07-23") returns the date 2002-07-23.cast as xs:date ("2002-07") generates a runtime error because the value cannot be converted to a date.Converts the input to a dateTime value.
This function uses the xf:date function.
Conforms to the current specification.
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.Converts the input to a decimal value.
This function uses the xf:decimal function.
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.Converts the input to a double precision value.
This function uses the xf:double function.
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.Converts the input to a floating point value.
This function uses the xf:float function.
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.Converts the input to an int value.
This function uses the xf:int function.
Conforms to the current specification.
Converts the input to an integer value.
This function uses the xf:integer function.
Conforms to the current specification.
Converts the input to a long value.
This function uses the xf:long function.
Conforms to the current specification.
Converts the input to a short value.
This function uses the xf:short function.
Conforms to the current specification.
Converts the input to a string value.
This function uses the xf:string function.
xf:string as both a constructor and an accessor.xsext:anyType input instead of a list of items.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.Converts the input to a time value.
This function uses the xf:time function.
Conforms to the current specification.
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).
XQuery has operators that are specific to comparisons operations. The following operators are available:
Returns true if Parameter1 is exactly equal to Parameter2.
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.
Returns true if Parameter1 is greater than or equal to Parameter2.
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.
See the examples for eq.
Returns true if Parameter1 is greater than Parameter2.
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.
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.
See the examples for the "eq" operator (previous entry in this table).
Returns true if Parameter1 is less than or equal to Parameter2.
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.
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.
See the examples for for eq.
Returns true if Parameter1 is less than or equal to Parameter2.
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.
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.
See the examples for for eq.
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.
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.
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.
See the examples for eq.
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. The following constructor functions are available:
Returns a boolean value of true or false from the string source value.
If the input parameter is empty, the function returns an empty list. Otherwise, Liquid Data generates an error.
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.Constructs a byte integer value from the string source value.
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.
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. Constructs a decimal value from the source value.
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.Constructs a double precision value from the source value.
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.Constructs a floating point value from the source value.
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.Constructs an integer value from the source value. The largest integer value is limited to a 32-bit expression.
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.
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.Constructs an integer value from the source value. The largest integer value is limited to a 32-bit expression.
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.
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.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.
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.
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.Constructs a two-byte integer value from the source value. The largest short integer value is limited to a 16-bit expression.
An error occurs if the source value is greater than 32,767 or less than -32,768.
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.Constructs a string value from the source value. The source value can be a sequence, a node of any kind, or a simple value.
Liquid Data accepts any simple value, but supports no other accessor types, such as a sequence or other type of node.
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.
Date and Time functions extract all or part of a dateTime expression and use it in a query. The following date and time functions are available:
Adds the number of days specified by Parameter2 to the date specified by Parameter1. The value of Parameter2 may be negative.
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.
Conforms to the current specification.
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.Returns the current date and time.
Returned data type: xs:dateTime
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.
Liquid Data returns the time zone where the Liquid Data Server is running.
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).
Takes a string (rather than dateTime) and a parameter and returns a date from a source value, which must contain a date in one of these formats:
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.
Conforms to the current specification.
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.Returns a dateTime value from a source value, which must contain a date and time in one of these formats:
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.
Conforms to the current specification.
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 Returns an integer value representing the day identified in date.
The day value ranges from 1 to 31.
If the source value is an empty list, the function returns an empty list.
Conforms to the current specification.
xf:get-day-from-date(xf:date("2002-07-15")) returns the integer value 15.xf:get-hours-from-dateTime(()) returns an empty list ().Returns an integer value representing the day identified in dateTime.
The day value ranges from 1 to 31.
If the source value is an empty list, the function returns an empty list.
Conforms to the current specification.
xf:get-day-from-dateTime(xf:dateTime("2004-01-07T21:09:44")) returns the integer value 7.xf:get-hours-from-dateTime(()) returns an empty list ().Returns an integer value representing the hour identified in dateTime.
The hour value ranges from 0 to 23.
If the source value is an empty list, the function returns an empty list.
Conforms to the current specification.
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 ().Returns an integer representing the hour identified in time.
The hour value ranges from 0 to 23, inclusive.
If the source value is an empty list, the function returns an empty list.
Conforms to the current specification.
xf:get-hours-from-time(xf:time("21:09:44")) returns the integer value 21.xf:get-hours-from-time(()) returns an empty list (). Returns an integer value representing the minutes identified in dateTime.