Classes em Java: trabalhando com Date, Calendar e SimpleDateFormat

As classes apresentadas neste artigo demonstram como a programaç�o em Java consegue manipular as datas, horas e internacionaliz�-las. No Java o tempo � representado em milissegundos, sendo medido a partir da data 01/01/1970. Essa data pode ser recuperada atrav�s do comando System.currentTimeMillis().

Abaixo s�o mostradas as principais classes utilizadas quando se trata de algum dado que envolva datas.

Classe Date

A data representa o tempo, um tempo � composto por ano, m�s, dia atual, minuto atual, entre outras propriedades que essa classe possui.

Hoje a maioria dos m�todos da classe Date est�o classificados como deprecated (depreciados), ou seja, s�o m�todos que n�o s�o mais utilizados, por isso essa classe foi substitu�da pela classe Calendar, para haver suporte correto � internacionalizaç�o do sistema de datas.

Saiba mais: Classe Calendar

Na Listagem 1 � instanciada a classe Date e exibida a data atual em detalhes.


import java.util.Date;

public class Testa_Date {
	public static void main(String[] args) {
		Date data = new Date();
		System.out.println("Data Agora: "+data);
	}
}

Listagem 1. Testando a classe Date

Classe Calendar

Essa classe pode produzir os valores de todos os campos de calend�rio necess�rios para implementar a formataç�o de data e hora, para uma determinada l�ngua e estilo de calend�rio. Por exemplo, japon�s, americano, italiano, brasileiro entre outros.

A classe Calendar � a mais usada quando se trata de datas, mas como � uma classe abstrata, n�o pode ser instanciada, portanto para obter um calend�rio � necess�rio usar o m�todo est�tico getInstance(), apresentado no exemplo da Listagem 2.


import java.util.Calendar;

public class Data_Calendar{

	public static void main(String[] args) {
		Calendar c = Calendar.getInstance();
		System.out.println("Data e Hora atual: �+c.getTime());
	}
}

Listagem 2. Recuperaç�o da data com a classe Calendar

Com a classe Calendar tamb�m se consegue manipular a data e hora com os m�todos que s�o fornecidos, abaixo seguem os exemplos.


import java.util.Calendar;

public class Testa_Metodo_Get_Calendar{

	public static void main(String[] args) {
		Calendar c = Calendar.getInstance();
		
		System.out.println("Data/Hora atual: "+c.getTime());
		System.out.println("Ano: "+c.get(Calendar.YEAR));
		System.out.println("M�s: "+c.get(Calendar.MONTH));
		System.out.println("Dia do M�s: "+c.get(Calendar.DAY_OF_MONTH));
	}
}

Listagem 3. Mostra o dia da semana, m�s e ano


import java.util.Calendar;

public class Testa_Metodos_Set_Get_Calendar{

	public static void main(String[] args) {
		Calendar c = Calendar.getInstance();
		c.set(Calendar.YEAR, 1995); 
		c.set(Calendar.MONTH, Calendar.MARCH); 
		c.set(Calendar.DAY_OF_MONTH, 20);
		
		System.out.println("Data/Hora atual: "+c.getTime());
		System.out.println("Ano: "+c.get(Calendar.YEAR));
		System.out.println("M�s: "+c.get(Calendar.MONTH));
		System.out.println("Dia do M�s: "+c.get(Calendar.DAY_OF_MONTH));
	}

}

Listagem 4. Alterando a data/hora com m�todo set

Na Listagem 5, mostra-se como recuperar a hora do dia, fazendo uma interaç�o com o usu�rio informando uma mensagem de boas vindas.


import java.util.Calendar;

public class Msg_Boas_Vindas_Calendar{

	public static void main(String[] args) {
		Calendar c1 = Calendar.getInstance();
		int hora = c1.get(Calendar.HOUR_OF_DAY);
		
if(hora > 6 && hora < 12){
			System.out.println("Bom Dia");
		}else if(hora > 12 && hora < 18){
			System.out.println("Boa Tarde");
		}else{
			System.out.println("Boa Noite");
		}
	}
}

Listagem 5. Recuperando a hora do dia

Para mais informaç�es sobre a classe Calendar, acesse o link para as Documentaç�es Oracle.

DateFormat

Essa classe permite converter informaç�es do tipo String para data do tipo Date, permitindo seguir um formato. Consegue-se trabalhar ao contr�rio, convertendo um dado do tipo Date para uma String. Por ser uma classe abstrata, n�o � poss�vel instanci�-la, por isso deve ser usado para m�todo est�tico getDateInstance(). Sempre quando declarado � preciso importar o pacote java.text.

Abaixo s�o mostrados alguns exemplos dos m�todos de formataç�o das datas.


import java.util.Calendar;
import java.text.DateFormat;
import java.util.Date;

public class Formatando_Datas{

	public static void main(String[] args) {
		Calendar c = Calendar.getInstance();
		c.set(2013, Calendar.FEBRUARY, 28);
		Date data = c.getTime();
		System.out.println("Data atual sem formataç�o: "+data);
		
		//Formata a data
		DateFormat formataData = DateFormat.getDateInstance();
		System.out.println("Data atual com formataç�o: "+ formataData.format(data));
		
		//Formata Hora
DateFormat hora = DateFormat.getTimeInstance();
		System.out.println("Hora formatada: "+hora.format(data));

		//Formata Data e Hora
		DateFormat dtHora = DateFormat.getDateTimeInstance();
		System.out.println(dtHora.format(data));

	}

}

Listagem 6. Formatando data atual


import java.util.Calendar;
import java.text.DateFormat;
import java.util.Date;

public class Formatando_Saida_Datas{

	public static void main(String[] args) {
		Calendar c = Calendar.getInstance();
		Date data = c.getTime();
		
		DateFormat f = DateFormat.getDateInstance(DateFormat.FULL); //Data COmpleta
		System.out.println("Data brasileira: "+f.format(data));

f = DateFormat.getDateInstance(DateFormat.LONG);
		System.out.println("Data sem o dia descrito: "+f.format(data));
		
		f = DateFormat.getDateInstance(DateFormat.MEDIUM);
		System.out.println("Data resumida 1: "+f.format(data));
		
		f = DateFormat.getDateInstance(DateFormat.SHORT);
		System.out.println("Data resumida 2: "+f.format(data));
	}
}

Listagem 7. Formataç�es de datas

Convers�es

�s vezes � preciso transformar um texto em uma data ou vice versa, para isso abaixo � exibida a funç�o parse e a classe SimpleDateFormat. Geralmente a classe SimpleDateFormat � mais usada quando trata-se de formataç�o de datas, pois j� no seu construtor, quando instanciada, permite passar como argumento o formato da data desejada, como apresentada nos exemplos abaixo.


import java.util.Calendar;
import java.text.DateFormat;
import java.util.Date;
import java.text.SimpleDateFormat;
import java.text.ParseException;

public class Conversao_Datas{

	public static void main(String[] args) throws ParseException{
		Calendar c = Calendar.getInstance();
		Date data = c.getTime();
		DateFormat f = DateFormat.getDateInstance();
		
		Date data2 = f.parse("12/01/1995");
		System.out.println(data2);
		
		SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy");
		System.out.println("Data formatada: "+sdf.format(data));
		
		//Converte Objetos
		System.out.println(�Data convertida: �+sdf.parse("02/08/1970"));
	}
}

Listagem 8. Convertendo Datas com m�todo parse e a classe SimpleDateFormat

Para mais detalhes, acesse o link para as Documentaç�es Oracle.

Saiba mais: Boas pr�ticas ao trabalhar com datas

Internacionalizaç�o das datas

O Java oferece a classe Locale, que permite definir de qual pa�s deseja-se obter o retorno das informaç�es, como data e hora. Nos exemplos acima n�o foi necess�rio instanciar essa classe, pois j� � detectado automaticamente do computador quais s�o as configuraç�es regionais. Na Listagem 9 � mostrado como formatar data e hora de acordo com outros pa�ses.


import java.util.Calendar;
import java.util.Locale;
import java.text.DateFormat;
import java.text.ParseException;
import java.util.Date;

public class Locale_Datas{

	public static void main(String[] args) throws ParseException {
		Calendar c = Calendar.getInstance();
		Date data = c.getTime();
		
		Locale brasil = new Locale("pt", "BR"); //Retorna do pa�s e a l�ngua
		Locale eua = Locale.US;
		Locale italia = Locale.ITALIAN;
		
		DateFormat f2 = DateFormat.getDateInstance(DateFormat.FULL, brasil);
		System.out.println(�Data e hora brasileira: �+f2.format(data));
		
		DateFormat f3 = DateFormat.getDateInstance(DateFormat.FULL, eua);
		System.out.println(�Data e hora americana: �+f3.format(data));
		
		DateFormat f4 = DateFormat.getDateInstance(DateFormat.FULL, italia);
		System.out.println(�Data e hora italiana: �+f4.format(data));
	}
}

Listagem 9. Internacionalizando datas

Veja neste link a lista dos c�digos referentes aos outros pa�ses, que podem ser usados como argumentos nos construtores da classe Locale. ISO-3166 Country Codes

Nota:

Saiba mais sobre a API de datas do Java
Curso relacionado:Java Aplicado

Trabalhando com as classes Date, Calendar e SimpleDateFormat em Java

Veja neste artigo como manipular as classes Date, Calendar e SimpleDateFormat, a converter Strings para tipos data e vice versa. Aprenda a internacionalizar as datas de acordo com a região e saiba algumas particularidades dessas classes.

Classe Date

Classe Calendar

DateFormat

Convers�es

Internacionalizaç�o das datas

Artigos relacionados