format-number Function
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Converte números em seqüências de caracteres.
Syntax
string format-number(number, string, string?)
Parameters
- número
Um número a ser convertido.
- seqüência de caracteres
Formato de seqüência de caracteres padrão.
- seqüência de caracteres
[opcional] Formato decimal.
Return Value
Converte números em seqüências de caracteres. A conversão é o resultado da formatação de número especificado no primeiro argumento (número), usando o formato especificado no segundo argumento (seqüência de caracteres) e aplicar as regras definidas na formato decimal nomeado no opcional de terceiro argumento (seqüência de caracteres). Se o terceiro argumento, o nome formato decimal, for omitido, o formato decimal usar como padrão é usado.
Remarks
O argumento número especifica a entrada valor. De exemplo, o número 5351.
A primeira argumento string Especifica o formato padrão. Para o "formato padrão" seqüência de caracteres, a seguinte caracteres são com suporte ". "; ","; "#", "%", "0" e o caractere per-mille Unicode (# x 2030). O "#" caractere é usado para descrever inteiros. O ". " e "" caracteres são usados para descrever a localidade e tipo de pontuação. O "0" caractere é dígitos aplicar usados antes e após o ". " caractere. Quando truncando dígitos para o direito do decimal pontos, o número será arredondado. O número à esquerda do ponto decimal nunca será truncado. Se um segundo argumento string for especificado, que representa um nome formato decimal, qualquer caractere pode ser usado em seqüência de caracteres o formato padrão.
Ambas as a entrada valor e os parâmetros seqüência de caracteres primeiro devem estar presentes ou um erro será ser acionado. Se o primeiro parâmetro não pode ser forçado para um número, a função deve retornar NaN. Se o segundo parâmetro não for um válido seqüência de caracteres padrão, o número que é o primeiro parâmetro é retornado como está.
Argumento string o segundo, se presente, representa o nome de uma formato decimal, como especificado usando o < xsl: decimal-formato > elemento. O nome formato decimal deve ser um nome qualificado. Se você especificar um nome formato decimal, deve haver um < xsl: decimal-formato > elemento na folha de estilo com o mesmo nome.
Exemplos
A seguinte função chamar retorna "5,351".
format-number(5351,"#,###")
A seguinte função chamar retorna "5351.00".
format-number(5351, "#.00")
A seguinte função chamar retorna "53.5100".
format-number(53.51, "#.0000")
A seguinte função chamar retorna "0053.5100".
format-number(53.51, "0000.0000")
A seguinte função chamar retorna "0053.51".
format-number(53.51, "0000.####")
A seguinte função chamar retorna "53.6".
format-number(53.56, "0.0")