JSF - f: convertDateTime

f: a tag convertDateTime é usada para converter um valor de string em uma data de formato necessário. Ele também atua como um validador, um formato de data obrigatório.

Tag JSF

<f:convertDateTime pattern = "dd-mm-yyyy" />

Atributos de tag

S.No Atributo e descrição
1

type

data (padrão), hora ou ambos

2

dateStyle

padrão, curto, médio, longo ou completo

3

timeStyle

padrão, curto, médio, longo ou completo

4

pattern

Padrão de formatação, conforme definido em java.text.SimpleDateFormat

5

locale

Local cujas preferências devem ser usadas para análise e formatação

6 timeZone

Fuso horário a ser usado para análise e formatação

Aplicação de exemplo

Vamos criar um aplicativo JSF de teste para testar a tag acima.

Degrau Descrição
1 Crie um projeto com o nome helloworld sob um pacote com.tutorialspoint.test conforme explicado no capítulo JSF - Primeira Aplicação .
2 Modifique home.xhtml conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3 Crie result.xhtml no diretório webapps conforme explicado abaixo.
4 Crie UserData.java como um bean gerenciado no pacote com.tutorialspoint.test conforme explicado abaixo.
5 Compile e execute o aplicativo para ter certeza de que a lógica de negócios está funcionando de acordo com os requisitos.
6 Por fim, construa o aplicativo na forma de um arquivo war e implante-o no Apache Tomcat Webserver.
7 Inicie seu aplicativo da web usando o URL apropriado, conforme explicado abaixo na última etapa.

UserData.java

package com.tutorialspoint.test;

import java.io.Serializable;
import java.util.Date;

import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;

@ManagedBean(name = "userData", eager = true)
@SessionScoped
public class UserData implements Serializable {
   private static final long serialVersionUID = 1L;
   public Date date;

   public Date getDate() {
      return date;
   }

   public void setDate(Date date) {
      this.date = date;
   }
}

home.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml"
   xmlns:h = "http://java.sun.com/jsf/html"
   xmlns:f = "http://java.sun.com/jsf/core">
   
   <h:head>
      <title>JSF tutorial</title>
   </h:head>
   
   <h:body>
      <h2>ConvertDateTime Example</h2>
      
      <h:form>
         <h:inputText id = "dateInput" value = "#{userData.date}"
            label = "Date" >
            <f:convertDateTime pattern = "dd-mm-yyyy" />
         </h:inputText>
         <h:commandButton value = "submit" action = "result"/>
      </h:form>
      <br/>
      <h:message for = "dateInput" style = "color:red" />
      
      <h:outputText value = "12-01-2012" >
         <f:convertDateTime pattern = "dd-mm-yyyy" />
      </h:outputText>
   
   </h:body>
</html>

result.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml"
   xmlns:f = "http://java.sun.com/jsf/core"
   xmlns:h = "http://java.sun.com/jsf/html"
   xmlns:ui = "http://java.sun.com/jsf/facelets">
   
   <h:body>
      <h2>Result</h2>
      <hr />
      #{userData.date}
   </h:body>
</html>

Assim que você estiver pronto com todas as mudanças feitas, vamos compilar e rodar a aplicação como fizemos no capítulo JSF - Primeira Aplicação. Se tudo estiver certo com sua aplicação, isso produzirá o seguinte resultado.

Insira qualquer valor inválido e pressione o botão Enviar. Veja a seguinte mensagem de erro.

Insira qualquer valor válido e pressione o botão Enviar. Veja o seguinte resultado.