Funciones XSLT y XPath
A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z
format-number | XSLT |
La función fn:format-number da formato al valor numérico introducido en el primer argumento a través del modelo de formato definido en los dos argumentos siguientes. El resultado de salida será una cadena.
El segundo argumento es obligatorio y define el formato base para el valor numérico (por ejemplo 03.75 ó 3.7500 mm). Con el carácter "0" se puede definir la ubicación de los ceros antes y después de la coma. Para las cifras que pueden omitirse se usa el carácter "#". Como separador entre números enteros y decimales se usa el punto. En la definición de formato introducida en el siguiente argumento es posible establecer otros caracteres para la salida. Este argumento constará del nombre completo de una definición definición formato declarada mediante xsl:decimal-format. A través de esta definición de formato es posible cambiar la definición de caracteres prefijados como "#" o "0", o bien establecer otra configuración para el punto decimal, separador de miles, o bien para caracteres NaN.
En caso de que el número indicado en el primer argumento tenga más cifras que las definidas en el modelo de formato, el número será redondeado por defecto. Con el carácter de separación ";" puede diferenciarse entre dos modelos de formato distintos para valores positivos y negativos respectivamente. Con el carácter de separación "-" se puede establecer la posición del signo negativo.
La función fn:format-number es exclusiva de XSLT, no siendo válida en XQuery o XPath.
Argumentos
Valor numérico
Es obligatorio, pero puede ser una secuencia vacía.
Tipo: xs:double
Modelo de formato
Obligatorio
Tipo: xs:string
Definición de formato
Opcional
Tipo: xs:string
Valor de salida
Valor numérico formateado como cadena
Tipo: xs:string
Ejemplo
format-number(3.57, '##.00#')
Resultado: 3.57
Ejemplo
format-number(3.579, '00.0#')
Resultado: 03.58
| > Volver a la referencia alfabética de XSLT y XPATH |