format-date
Formata uma data
Descrição
A função fn:format-date formata $value como string, usando a máscara indicada em $picture, o calendário indicado em $calendar, o idioma indicado em $language e o país indicado em $country. A sintaxe da máscara está na seção 16.5.1 da recomendação XSLT 2.0. Os três últimos argumentos são opcionais, mas, se você informar um, precisa informar os três (pode passar a sequência vazia). Observação: é uma função só do XSLT; não existe em XQuery nem em XPath puro.
Parâmetros |
Descrição |
|---|---|
value:date() |
a data a formatar |
picture:string() |
a máscara, feita de componentes entre colchetes, como [Y], [M01] ou [D] |
language:string() |
o idioma dos nomes de meses e dias, como en; opcional |
calendar:string() |
o calendário a usar, como AD; opcional |
country:string() |
o país, usado para escolher nomes e fusos horários; opcional |
Exemplos
XPath |
Resultado |
Explicação |
|---|---|---|
format-date(xs:date('2006-02-15'), '[D]/[M]/[Y]') |
15/2/2006 |
Dia, mês e ano sem zeros à esquerda. |
format-date(xs:date('2006-02-15'), '[Y0001]-[M01]-[D01]') |
2006-02-15 |
Ano com quatro dígitos, mês e dia com dois. |
format-date(xs:date('2006-02-15'), '[MNn] [D], [Y]') |
February 15, 2006 |
MNn é o nome do mês com a inicial maiúscula. |
format-date(xs:date('2006-02-15'), '[FNn], [D1o] [MNn] [Y]') |
Wednesday, 15th February 2006 |
FNn é o dia da semana, e D1o é o dia como número ordinal. |
format-date(xs:date('2006-02-15'), '[D] de [MNn] de [Y]', 'pt', (), ()) |
[Language: en]15 de February de 2006 |
Os nomes de meses e dias só existem em inglês: outros idiomas caem no inglês, e o resultado avisa isso. |