The namespaces for extensions defined in this document are:
Prefix | Namespace |
---|---|
date | http://exslt.org/dates-and-times |
dyn | http://exslt.org/dynamic |
exsl | http://exslt.org/common |
func | http://exslt.org/functions |
math | http://exslt.org/math |
regexp | http://exslt.org/regular-expressions |
set | http://exslt.org/sets |
str | http://exslt.org/strings |
The prefixes are given for this document only. Any other prefix can be used within a particular stylesheet.
Function | Syntax |
---|---|
date:add | unknown date:add(dateTime, duration) |
date:date | unknown date:date(dateTime) |
date:date-time | unknown date:date-time() |
date:day-abbreviation | unknown date:day-abbreviation(dateTime) |
date:day-in-month | unknown date:day-in-month(dateTime) |
date:day-in-week | unknown date:day-in-week(dateTime) |
date:day-in-year | unknown date:day-in-year(dateTime) |
date:day-name | unknown date:day-name(dateTime) |
date:day-of-week-in-month | unknown date:day-of-week-in-month(dateTime) |
date:difference | unknown date:difference(dateTime1, dateTime2) |
date:hour-in-day | unknown date:hour-in-day(dateTime) |
date:leap-year | unknown date:leap-year(dateTime) |
date:minute-in-hour | unknown date:minute-in-hour(dateTime) |
date:month-abbreviation | unknown date:month-abbreviation(dateTime) |
date:month-in-year | unknown date:month-in-year(dateTime) |
date:month-name | unknown date:month-name(dateTime) |
date:second-in-minute | unknown date:second-in-minute(dateTime) |
date:seconds | unknown date:seconds(dateOrDuration) |
date:time | unknown date:time(dateTime) |
date:week-in-year | unknown date:week-in-year(dateTime) |
date:year | unknown date:year(dateTime) |
dyn:evaluate | unknown dyn:evaluate(string) |
exsl:node-set | unknown exsl:node-set(obj) |
exsl:object-type | unknown exsl:object-type(obj) |
math:abs | unknown math:abs(num) |
math:acos | unknown math:acos(num) |
math:asin | unknown math:asin(num) |
math:atan | unknown math:atan(num) |
math:atan2 | unknown math:atan2(y, x) |
math:constant | unknown math:constant(name, precision) |
math:cos | unknown math:cos(num) |
math:exp | unknown math:exp(num) |
math:highest | unknown math:highest(nodeset) |
math:log | unknown math:log(num) |
math:lowest | unknown math:lowest(nodeset) |
math:max | unknown math:max(nodeset) |
math:min | unknown math:min(nodeset) |
math:power | unknown math:power(base, exponent) |
math:random | unknown math:random() |
math:sin | unknown math:sin(num) |
math:sqrt | unknown math:sqrt(num) |
math:tan | unknown math:tan(num) |
regexp:match | unknown regexp:match(source, pattern, flags) |
regexp:replace | unknown regexp:replace(source, pattern, flags, repl) |
regexp:test | unknown regexp:test(source, pattern, flags) |
set:difference | unknown set:difference(nodes1, nodes2) |
set:distinct | unknown set:distinct(nodeset) |
set:has-same-node | unknown set:has-same-node(ns1, ns2) |
set:intersection | unknown set:intersection(ns1, ns2) |
set:leading | unknown set:leading(ns1, ns2) |
set:trailing | unknown set:trailing(ns1, ns2) |
str:align | unknown str:align(target, padding, alignment) |
str:concat | unknown str:concat(nodeset) |
str:decode-uri | unknown str:decode-uri(uri, encoding) |
str:encode-uri | unknown str:encode-uri(uri, escapeReserved, encoding) |
str:padding | unknown str:padding(length, chars) |
str:replace | unknown str:replace(s, searchNodes, replNodes) |
str:split | unknown str:split(string, pattern) |
str:tokenize | unknown str:tokenize(string, delimiters) |
Element | Syntax |
---|---|
exsl:document | <exsl:document
href = { uri-reference } cdata-section-elements = { qnames } doctype-public = { string } doctype-system = { string } encoding = { string } indent = { "yes" | "no" } media-type = { string } method = { qname } omit-xml-declaration = { "yes" | "no" } standalone = { "yes" | "no" } version = { nmtoken } <!-- Content: template --> /> |
func:function | <func:function
name = qname-but-not-ncname <!-- Content: (xsl:param*, template) --> /> |
func:result | <func:result
select = expression <!-- Content: template --> /> |
The date:add function returns the result of adding a duration to a dateTime.
The date:date function returns the date portion of the dateTime argument if present, or of the current local date/time. The argument can be given in xs:dateTime or xs:date format. Non-conformance issues: The dateTime argument must be given in ISO 8601 date/time or date format, so an xs:date format with a time zone is not supported. Also, EXSLT requires that the result must include a time zone unless there was an argument given and it did not have a time zone. If a date/time argument is given, this implementation returns the date with no time zone info.
The date:date-time function returns the current local date/time as an ISO 8601 formatted date/time string, with a time zone.
The date:day-abbreviation function returns the English abbreviation for the day name of a given date.
The date:day-in-month function returns the numerical date, i.e. 27 for the 27th of March.
The date:day-in-week function returns a number representing the weekday of a given date. Sunday is 1, Saturday is 7.
The date:day-in-year function returns a number representing the position of a date in the year.
The date:day-name function returns the full English day name of a given date.
The date:day-of-week-in-month function returns the day-of-the-week in a month of a date as a number (e.g. 3 for the 3rd Tuesday in May).
The date:difference function returns the difference between dt1 and dt2 as a duration in string form. According to the spec (http://exslt.org/date/functions/difference/index.html) "If the date/time string with the least specific format is in either xs:gYearMonth or xs:gYear format, then the number of days, hours, minutes and seconds in the duration string must be equal to zero. (The format of the string will be PnYnM.) The number of months specified in the duration must be less than 12." "Otherwise, the number of years and months in the duration string must be equal to zero. (The format of the string will be PnDTnHnMnS.) The number of seconds specified in the duration string must be less than 60; the number of minutes must be less than 60; the number of hours must be less than 24." This method does not account for leap seconds, so you should not expect precise results over long time spans.
The date:hour-in-date function returns the hour portion of a date- time string as an integer.
The date:leap-year function returns true if the year argument (defaults to current year) is a leap year, false otherwise.
The date:minute-in-hour function returns the minute portion of a date-time string as an integer.
The date:month-abbreviation function returns the abbreviation of the month of a date.
The date:month-in-year function returns the month portion of the dateTime argument (defaults to current year) as an integer.
The date:month-name function returns the full English name of the month portion of a date.
The date:second-in-minute function returns the seconds portion of a date-time string as an integer.
The date:time function returns the time portion of the dateTime argument if present, or of the current local date/time. The argument can be given in xs:dateTime or xs:time format. Non-conformance issue: EXSLT requires that the result must include a time zone unless there was an argument given and it did not have a time zone. If an argument is given, this implementation returns the result with time zone info, always.
The date:week-in-year function returns a number representing the week of the year a date is in.
The date:year function returns the year portion of the dateTime supplied, or of the current year, as an integer.
The dyn:evaluate function evaluates a string as an XPath expression and returns the resulting value, which might be a boolean, number, string, node set, result tree fragment or external object. The sole argument is the string to be evaluated.
The purpose of the exsl:node-set function is to return a node-set from a result tree fragment. If the argument is a node-set already, it is simply returned as is. If the argument to exsl:node-set is not a node-set or a result tree fragment, then it is converted to a string as by the string() function, and the function returns a node-set consisting of a single text node with that string value. The exsl:node-set function does not have side-effects: the result tree fragment used as an argument is still available as a result tree fragment after it is passed as an argument to exsl:node-set.
The exsl:object-type function returns a string giving the type of the object passed as the argument. The possible object types are: 'string', 'number', 'boolean', 'node-set', 'RTF' or 'external'.
The math:abs function returns the absolute value of a number.
The math:acos function returns the arccosine value of a number.
The math:asin function returns the arcsine value of a number.
The math:atan function returns the arctangent value of a number.
The math:atan2 function returns the angle ( in radians ) from the X axis to a point (y,x).
The math:constant function returns the specified constant to a set precision.
The math:cos function returns cosine of the passed argument.
The math:exp function returns e (the base of natural logarithms) raised to a power.
The math:highest function returns the nodes in the node set whose value is the maximum value for the node set. The maximum value for the node set is the same as the value as calculated by math:max. A node has this maximum value if the result of converting its string value to a number as if by the number function is equal to the maximum value, where the equality comparison is defined as a numerical comparison using the = operator.
The math:log function returns the natural logarithm of a number.
The math:lowest function returns the nodes in the node set whose value is the minimum value for the node set. The minimum value for the node set is the same as the value as calculated by math:min. A node has this minimum value if the result of converting its string value to a number as if by the number function is equal to the minimum value, where the equality comparison is defined as a numerical comparison using the = operator.
The math:max function returns the maximum value of the nodes passed as the argument.
The math:min function returns the minimum value of the nodes passed as the argument.
The math:power function returns the value of a base expression taken to a specified power.
The math:random function returns a random number from 0 to 1.
The math:sin function returns the sine of the number.
The math:sqrt function returns the square root of a number.
The math:tan function returns the tangent of the number passed as an argument.
The regexp:match function lets you get hold of the substrings of the string passed as the first argument that match the captured parts of the regular expression passed as the second argument. The second argument is a regular expression that follows the Javascript regular expression syntax. The third argument is a string consisting of character flags to be used by the match. If a character is present then that flag is true. The flags are: g: global match - the submatches from all the matches in the string are returned. If this character is not present, then only the submatches from the first match in the string are returned. i: case insensitive - the regular expression is treated as case insensitive. If this character is not present, then the regular expression is case sensitive. The regexp:match function returns a node set of 'match' elements, each of whose string value is equal to a portion of the first argument string that was captured by the regular expression. If the match is not global, the first match element has a value equal to the portion of the string matched by the entire regular expression.
The regexp:replace function replaces the parts of a string that match a regular expression with another string. The first argument is the string to be matched and replaced. The second argument is a regular expression that follows the Javascript regular expression syntax. The fourth argument is the string to replace the matched parts of the string. The third argument is a string consisting of character flags to be used by the match. If a character is present then that flag is true. The flags are: g: global replace - all occurrences of the regular expression in the string are replaced. If this character is not present, then only the first occurrence of the regular expression is replaced. i: case insensitive - the regular expression is treated as case insensitive. If this character is not present, then the regular expression is case sensitive.
The regexp:test function returns true if the string given as the first argument matches the regular expression given as the second argument. The second argument is a regular expression that follows the Javascript regular expression syntax. The third argument is a string consisting of flags to be used by the test. If a character is present then that flag is true. The flags are: g: global test - has no effect on this function, but is retained for consistency with regexp:match and regexp:replace. i: case insensitive - the regular expression is treated as case insensitive. If this character is not present, then the regular expression is case sensitive.
The set:difference function returns the difference between two node sets - those nodes that are in the node set passed as the first argument that are not in the node set passed as the second argument.
The set:distinct function returns a subset of the nodes contained in the node-set NS passed as the first argument. Specifically, it selects a node N if there is no node in NS that has the same string value as N, and that precedes N in document order.
The set:has-same-node function returns true if the node set passed as the first argument shares any nodes with the node set passed as the second argument. If there are no nodes that are in both node sets, then it returns false.
The set:intersection function returns a node set comprising the nodes that are within both the node sets passed as arguments to it.
The set:leading function returns the nodes in the node set passed as the first argument that precede, in document order, the first node in the node set passed as the second argument. If the first node in the second node set is not contained in the first node set, then an empty node set is returned. If the second node set is empty, then the first node set is returned.
The set:trailing function returns the nodes in the node set passed as the first argument that follow, in document order, the first node in the node set passed as the second argument. If the first node in the second node set is not contained in the first node set, then an empty node set is returned. If the second node set is empty, then the first node set is returned.
The str:align function aligns a string within another string. See http://exslt.org/str/functions/align/str.align.html for further explanation.
The str:concat function takes a node set and returns the concatenation of the string values of the nodes in that node set. If the node set is empty, it returns an empty string.
The str:decode-uri function decodes a percent-encoded string, such as one would find in a URI.
The str:encode-uri function percent-encodes a string for embedding in a URI. The second argument is a boolean indicating whether to escape reserved characters; if true, the given string can be a URI already, with just some of its characters needing to be escaped (not recommended, but users who don't understand the nuances of the URI syntax tend to prefer it over assembling a URI piece-by-piece).
The str:padding function creates a padding string of a certain length. The second argument gives a string to be used to create the padding. This string is repeated as many times as is necessary to create a string of the length specified by the first argument; if the string is more than a character long, it may have to be truncated to produce the required length. If no second argument is specified, it defaults to a space (' ').
The str:replace function converts a string to a node-set, with each instance of a substring from a given list (obtained from the string-values of nodes in the second argument) replaced by the node at the corresponding position of the node-set given as the third argument. Unreplaced substrings become text nodes. The second and third arguments can be any type of object; if either is not a node-set, it is treated as if it were a node-set of just one text node, formed from the object's string-value. Attribute and namespace nodes in the replacement set are erroneous but are treated as empty text nodes. All occurrences of the longest substrings are replaced first, and once a replacement is made, that span of the original string is no longer eligible for future replacements. An empty search string matches between every character of the original string. See http://exslt.org/str/functions/replace/str.replace.html for details.
The str:split function splits up a string and returns a node set of token elements, each containing one token from the string. The first argument is the string to be split. The second argument is a pattern string (default=' '). The string given by the first argument is split at any occurrence of this pattern. An empty string pattern will result in a split on every character in the string.
The str:tokenize function splits up a string and returns a node set of 'token' elements, each containing one token from the string. The first argument is the string to be tokenized. The second argument is a string consisting of a number of characters. Each character in this string is taken as a delimiting character. The string given by the first argument is split at any occurrence of any of these characters.
For full specification, see: http://www.exslt.org/exsl/elements/document/index.html