Manipulando Datas em Java com o framework Joda Time

Calcular a diferen�a de dias entre duas datas � um problema bastante recorrente em aplica��es. Por exemplo, se for criado um filtro com data de in�cio e data de fim, mas a diferen�a entre as duas datas n�o pode ser maior que 30 dias, ou as duas datas tem que estar no mesmo m�s. Outro exemplo � para quando for necess�rio saber quantos dias ou horas faltam para um determinado evento.

At� o Java 7, as APIs padr�o da plataforma para manipula��o de datas n�o possu�am m�todos para a compara��o direta de datas. Para fazer isso era necess�rio converter as datas para long, e com as datas neste formato fazer a compara��o. Isso � um problema porque al�m de ser dif�cil de implementar, tamb�m � dif�cil de entender o que est� acontecendo no c�digo. E essa compara��o s� vai funcionar para intervalos fixos, como dia e horas, mas para meses e anos que podem ter diferentes intervalos ser�o ainda mais dif�ceis de implementar. No Java 8 foi criada uma nova API para facilitar estas tarefas.

Mas em projetos que n�o podem ser atualizados para a vers�o mais recente da plataforma, � poss�vel utilizar o framework Joda Time, que � um projeto que tem como objetivo facilitar a manipula��o de datas em Java. O Joda Time possui m�todos para a compara��o, formata��o e cria��o de datas, al�m de ter diversos m�todos para a representa��o e recupera��o de informa��es sobre datas.

Atualmente o Joda time est� na vers�o 2.5 que foi lan�ada em outubro de 2013. O framework foi a base para a nova API de datas criadas na vers�o 8 do Java.

Configura��o do Projeto

Para configurar o projeto que utilizar� o Joda Time basta incluir o .jar do framework no build-path do projeto. O jar do framework pode ser encontrado no site do projeto Joda Time. Tamb�m � poss�vel configurar o projeto com o Maven, e para isso a Listagem 1 mostra como pode ser feito.


<dependency>
   <groupId>joda-time</groupId>
   <artifactId>joda-time</artifactId>
   <version>2.5</version>
</dependency>

Listagem 1. Inclus�o da depend�ncia do Joda Time no projeto com o Maven

Exemplos de utiliza��o do Joda Time

Para a utiliza��o de datas no JodaTime � utilizada a classe org.joda.time.DateTime, que complementa a classe java.util.Date da plataforma Java. A Listagem 2 mostra como utilizar essa classe e mostra tamb�m algumas funcionalidades interessantes da classe. Primeiro mostra como recuperar o nome do m�s como String e depois mostra como recuperar qual o dia da semana, tamb�m em String da data escolhida. Por fim, mostra como pegar o ano da data criada. Existem diversas outras op��es de como pegar os nomes em diferentes l�nguas e recuperar diversas outras informa��es sobre a data. A Figura 1 mostra a sa�da com a execu��o desses m�todos.


DateTime dataFinal = new DateTime();
DateTime dataInicio = new DateTime(2011, 1, 1, 0, 0);
         
System.out.println("M�s ShortString: " 
+ dataFinal.monthOfYear().getAsShortText());
System.out.println("M�s Italiano: " 
+ dataFinal.monthOfYear().getAsShortText(Locale.ITALIAN));
System.out.println("M�s String: " 
+ dataFinal.monthOfYear().getAsText());
System.out.println("Semana do Ano: " 
+ dataFinal.getWeekOfWeekyear());
                   
System.out.println("Dia da semana String: " 
+ dataFinal.dayOfWeek().getAsText());
System.out.println("Dia da semana Franc�s: " 
+ dataFinal.dayOfWeek().getAsText(Locale.FRENCH));
System.out.println("Dia da semana Italiano: " 
+ dataFinal.dayOfWeek().getAsText(Locale.ITALIAN));
 
System.out.println("Ano: " + dataFinal.year().get());
System.out.println("Ano no seculo atual:" + dataFinal.yearOfCentury().get());

Listagem 2. Classe DateTime do JodaTime

execu��o dos m�todos do joda time — **Figura 1**. Execu��o dos m�todos do Joda Time

Outra funcionalidade muito �til do Joda Time � a compara��o entre datas. � poss�vel comparar duas datas de diversas maneiras, descobrindo quantos meses, anos, dias, horas, minutos existem entre duas datas. A Listagem 3 mostra um exemplo de como fazer essa compara��o. Primeiro � feita a compara��o com a classe Days: o m�todo daysBetween compara a quantidade de dias entre uma data inicial e uma data final. O m�todo yearsBetween da classe Years compara os anos de diferen�a entre duas datas. O m�todo HoursBetween da classe Hours compara as horas de diferen�a entre as duas datas e o m�todo monthsBetween da classe Month compara os meses de diferen�a entre as duas datas.


DateTime dataFinal = new DateTime();
DateTime dataInicio = new DateTime(2011, 1, 1, 0, 0);
 
Days d = Days.daysBetween(dataInicio, dataFinal);
System.out.println("Diferen�a dias:" + d.getDays());
                   
Years y = Years.yearsBetween(dataInicio, dataFinal);
System.out.println("Diferen�a anos:" + y.getYears());
                   
Hours h = Hours.hoursBetween(dataInicio, dataFinal);
System.out.println("Diferen�a horas:" +h.getHours());
                   
Months m = Months.monthsBetween(dataInicio, dataFinal);
System.out.println("Diferen�a meses:" + m.getMonths());

Listagem 3. Diversas compara��es entre duas datas

A Figura 2 mostra a execu��o das classes e m�todos para a compara��o de datas do Joda Time.

execu��o dos m�todos de compara��o datas do joda time — **Figura 2**. Execu��o dos m�todos de compara��o de datas do Joda Time

O Joda time tamb�m tem uma funcionalidade para descobrir um intervalo e a dura��o entre duas datas. Para isso s�o utilizadas as classes org.joda.time.Interval e org.joda.time.Duration. Inicialmente descobrimos o intervalo entre uma data in�cio e uma data fim, que � sempre representado em milissegundos. Com o intervalo criado, podemos criar um objeto do tipo Duration, que tem a dura��o entre as duas datas e essa dura��o pode ser recuperada em milissegundos, dias, horas e segundos. A Listagem 4 mostra como isso pode ser feito.


DateTime dataFinal = new DateTime();
DateTime dataInicio = new DateTime(2011, 1, 1, 0, 0);
 
Interval intervalo = new Interval(dataInicio, dataFinal);
System.out.println(intervalo);
                   
Duration duracao = intervalo.toDuration();
System.out.println("Dura��o milisegundos:" + duracao.getMillis());
System.out.println("Dura��o dias:" + duracao.getStandardDays());
System.out.println("Dura��o horas:" + duracao.getStandardHours());
System.out.println("Dura��o segundos:" + duracao.getStandardSeconds());

Listagem 4. Intervalo e dura��o entre duas datas

A Figura 3 mostra a execu��o do c�digo que cria o intervalo e a dura��o entre as vari�veis dataFinal e DataInicio.

intervalo e dura��o entre as vari�veis datainicio datafinal — **Figura 3**. Intervalo e dura��o entre as vari�veis dataInicio e DataFinal

A Listagem 5 mostrar como recuperar o per�odo entre duas datas. A diferen�a do per�odo e a dura��o, � que a dura��o � a compara��o total entre as datas e o resultado � retornado em milissegundos. J� o per�odo � a compara��o feita campo a campo, onde � comparado dia com dia, m�s com m�s, e assim por diante. Por exemplo, o per�odo entre as datas 10/10 /2012 e 15/12/2014 � de 5 dias, 2 meses e 2 anos.


DateTime dataFinal = new DateTime();
DateTime dataInicio = new DateTime(2011, 1, 1, 0, 0);
 
Interval intervalo = new Interval(dataInicio, dataFinal);
System.out.println(intervalo);
                                      
Period period = intervalo.toPeriod();
System.out.println("Anos do periodo:" + period.getYears());
System.out.println("Meses do periodo:" + period.getMonths());
System.out.println("Dias do periodo:" + period.getDays());
System.out.println("Horas do periodo:" + period.getHours());

Listagem 5. Per�odo entre duas datas

A Figura 4 mostra a execu��o do c�digo que cria o per�odo entre as vari�veis dataFinal e DataInicio.

per�odo entre as vari�veis datainicio e datafinal — **Figura 4**. Per�odo entre as vari�veis dataInicio e DataFinal

Outra funcionalidade do Joda Time � a formata��o das datas, isso � bastante parecido com a formata��o de datas com a classe SimpleDateFormat da plataforma Java. Para a formata��o de datas com o Joda Time s�o utilizadas as classes org.joda.time.format.DateTimeFormatter e org.joda.time.format.DateTimeFormatter. Como a Listagem 6 mostra, � criado o formatador com padr�o que a data deve ser exibida e para utilizar esse formato, o objeto da classe DateTimeFormatter deve ser passado como par�metro para o m�todo toString das datas.


DateTimeFormatter dtfPadrao = DateTimeFormat.forPattern("dd/MM/yyyy");
System.out.println("Data formatada Padrao: " + dataInicio.toString(dtfPadrao));
System.out.println("Data formatada Padrao: " + dataFinal.toString(dtfPadrao));
                   
DateTimeFormatter dtfExtenso = DateTimeFormat.forPattern("dd 'de' MMMM 'de' yyyy");
System.out.println("Data formatada Extenso: " + dataInicio.toString(dtfExtenso));
System.out.println("Data formatada Extenso: " + dataFinal.toString(dtfExtenso));

Listagem 6. Formata��o de datas com o Joda Time

A Figura 5 mostra a execu��o do c�digo que formata as datas, primeiro com padr�o �dd/MM/yyyy� e depois com o padr�o �dd �de� MMMM �de� yyyy�.

formata��o das datas com o joda time — **Figura 5**. Formata��o das datas com o Joda Time

Como mostra a Listagem 7, � poss�vel fazer opera��es com as datas no Joda Time como, por exemplo, acrescentar ou remover dias, meses, anos, segundos, entre outros. Uma coisa importante do Joda Time � que assim como a classe String, os objetos do tipo DateTime s�o imut�veis. Isso quer dizer que, mesmo chamando algum m�todo como, por exemplo, data.plusDays(1), o objeto que executou esse m�todo n�o ser� alterado. O m�todo criar� outro objeto que ter� o objeto inicial como base, mas os dados alterados pelo m�todo executado.


DateTime data = new DateTime();
DateTime dataMaisDias = data.plusDays(100);
DateTime dataMaisAno = data.plusWeeks(10);
DateTime dataMaisSemanas = data.plusYears(5);
DateTime dataMaisHoras = data.plusHours(100);
DateTime dataMenosDias = data.minusDays(100);
                                      
System.out.println(dataMaisDias);
System.out.println(dataMaisAno);
System.out.println(dataMaisSemanas);
System.out.println(dataMaisHoras);
System.out.println(dataMenosDias);

Listagem 7. Opera��es em datas

A Figura 6 mostra a execu��o do c�digo que realiza as opera��es nas datas, entre eles a de adicionar dias, meses ou a de remover dias.

opera��es em datas no joda time — **Figura 6**. Opera��es em datas no Joda Time

Para mostrar como utilizar o Joda Time, a Listagem 8 mostra alguns exemplos pr�ticos do uso. O primeiro m�todo, chamado horasAnoNovo, recebe uma data e um ano qualquer como par�metro. Com isso, � calculado quantas horas faltam para se chegar a virada de ano do ano passado como par�metro para o m�todo. O segundo m�todo, chamado diasAnoNovo, faz a mesma coisa, mas retorna a quantidades de dias que faltam para o ano novo.

O terceiro m�todo, chamado diaSemanaAniversario, recebe como par�metro uma data qualquer, que representa o anivers�rio de algu�m e retorna uma String com o dia da semana dessa data. O quarto m�todo, chamado intervaloMaiorTrintaDias, compara a diferen�a de dias entre duas datas: se essa diferen�a for maior que 30 dias retorna true, caso seja menor retorna false.


public static int horasAnoNovo(DateTime data, int ano) {
         DateTime dataFinal = new DateTime(ano, 1, 1, 0, 0);
         return Hours.hoursBetween(data, dataFinal).getHours();
}
public static int diasAnoNovo(DateTime data, int ano) {
         DateTime dataFinal = new DateTime(ano, 1, 1, 0, 0);
         return Days.daysBetween(data, dataFinal).getDays();
}
public static String diaSemanaAniversario(DateTime data) {
         return data.dayOfWeek().getAsText();
}
 
public static boolean intervaloMaiorTrintaDias(DateTime dataInicial, 
DateTime dataFinal) {
         Days dias = Days.daysBetween(dataInicial, dataFinal);
         if (dias.getDays() > 30) {
                   return true;
         }
         return false;
}

Listagem 8. Exemplos de uso do Joda Time

A Figura 7 mostra a execu��o da chamada aos m�todos criados: primeiro do m�todo horasAnoNovo com os par�metros 05/11/2014 e 2030; depois do m�todo diasAnoNovo com os par�metros 05/11/2014 e 2030; depois do m�todo diaSemanaAniversario com o par�metro 07/03/2030 e, por �ltimo, do m�todo intervaloMaiorTrintaDias om os par�metros 05/11/2014 e 10/10/2015.

execu��o dos m�todos de exemplo — **Figura 7**. Execu��o dos m�todos de exemplo

Para facilitar a compreens�o, a Listagem 9 mostra o c�digo completo do exemplo desenvolvido para esse artigo.


package teste;

import java.util.Locale;

import org.joda.time.DateTime;
import org.joda.time.Days;
import org.joda.time.Duration;
import org.joda.time.Hours;
import org.joda.time.Interval;
import org.joda.time.Months;
import org.joda.time.Period;
import org.joda.time.Years;
import org.joda.time.format.DateTimeFormat;
import org.joda.time.format.DateTimeFormatter;

public class Main {

 public static void main(String[] args) {
   
   DateTime dataFinal = new DateTime();
   DateTime dataInicio = new DateTime(2011, 1, 1, 0, 0);
   
   System.out.println("M�s ShortString: " 
   + dataFinal.monthOfYear().getAsShortText());
   System.out.println("M�s Italiano: " 
   + dataFinal.monthOfYear().getAsShortText(Locale.ITALIAN));
   System.out.println("M�s String: " 
   + dataFinal.monthOfYear().getAsText());
   System.out.println("Semana do Ano: " 
   + dataFinal.getWeekOfWeekyear());
   
   System.out.println("Dia da semana String: " 
   + dataFinal.dayOfWeek().getAsText());
   System.out.println("Dia da semana Franc�s: " 
   + dataFinal.dayOfWeek().getAsText(Locale.FRENCH));
   System.out.println("Dia da semana Italiano: " 
   + dataFinal.dayOfWeek().getAsText(Locale.ITALIAN));

   System.out.println("Ano: " + dataFinal.year().get());
   System.out.println("Ano no seculo atual:" 
   + dataFinal.yearOfCentury().get());
   
   Days d = Days.daysBetween(dataInicio, dataFinal);
   System.out.println("Diferen�a dias:" + d.getDays());
   
   Years y = Years.yearsBetween(dataInicio, dataFinal);
   System.out.println("Diferen�a anos:" + y.getYears());
   
   Hours h = Hours.hoursBetween(dataInicio, dataFinal);
   System.out.println("Diferen�a horas:" +h.getHours());
   
   Months m = Months.monthsBetween(dataInicio, dataFinal);
   System.out.println("Diferen�a meses:" + m.getMonths());
   
   Interval intervalo = new Interval(dataInicio, dataFinal);
   System.out.println(intervalo);
   
   Duration duracao = intervalo.toDuration();
   System.out.println("Dura��o milisegundos:" + duracao.getMillis());
   System.out.println("Dura��o dias:" + duracao.getStandardDays());
   System.out.println("Dura��o horas:" + duracao.getStandardHours());

System.out.println("Dura��o segundos:" + duracao.getStandardSeconds());
   
   Period period = intervalo.toPeriod();
   System.out.println("Anos do periodo:" + period.getYears());
   System.out.println("Meses do periodo:" + period.getMonths());
   System.out.println("Dias do periodo:" + period.getDays());
   System.out.println("Horas do periodo:" + period.getHours());
   
   DateTime data = new DateTime();
   DateTime dataMaisDias = data.plusDays(100);
   DateTime dataMaisAno = data.plusWeeks(10);
   DateTime dataMaisSemanas = data.plusYears(5);
   DateTime dataMaisHoras = data.plusHours(100);
   DateTime dataMenosDias = data.minusDays(100);
                      
   System.out.println(dataMaisDias);
   System.out.println(dataMaisAno);
   System.out.println(dataMaisSemanas);
   System.out.println(dataMaisHoras);
   System.out.println(dataMenosDias);
   
   DateTimeFormatter dtfPadrao = DateTimeFormat
   .forPattern("dd/MM/yyyy");
   System.out.println("Data formatada Padrao: " 
   + dataInicio.toString(dtfPadrao));
   System.out.println("Data formatada Padrao: " 
   + dataFinal.toString(dtfPadrao));
   
   DateTimeFormatter dtfExtenso = DateTimeFormat
   .forPattern("dd 'de' MMMM 'de' yyyy");
   System.out.println("Data formatada Extenso: " 
   + dataInicio.toString(dtfExtenso));
   System.out.println("Data formatada Extenso: " 
   + dataFinal.toString(dtfExtenso));
   
   System.out.println("Horas que faltam ano novo: " 
   + horasAnoNovo(new DateTime(), 2030));
   System.out.println("Dias que faltam ano novo: " 
   + diasAnoNovo(new DateTime(), 2030));
   System.out.println("O seu anivers�rio cai em uma: " 
   + diaSemanaAniversario(new DateTime(2030, 3, 7, 0, 0)));
   System.out.println("O intervalo tem mais que 30 dias?" 
   + intervaloMaiorTrintaDias(dataInicio, dataFinal));
           
 }
 
 public static int horasAnoNovo(DateTime data, int ano) {
           
   DateTime dataFinal = new DateTime(ano, 1, 1, 0, 0);
   return Hours.hoursBetween(data, dataFinal).getHours();
           
 }
 
 public static int diasAnoNovo(DateTime data, int ano) {
   DateTime dataFinal = new DateTime(ano, 1, 1, 0, 0);
   return Days.daysBetween(data, dataFinal).getDays();
 }
 
 public static String diaSemanaAniversario(DateTime data) {
   return data.dayOfWeek().getAsText();
 }
 
 public static boolean intervaloMaiorTrintaDias(DateTime 
 dataInicial, DateTime dataFinal) {
   Days dias = Days.daysBetween(dataInicial, dataFinal);
   if (dias.getDays() > 30) {
      return true;
   }
   return false;
 } 

package teste;
}

Listagem 9. C�digo completo do exemplo desenvolvido no artigo

A Figura 8 mostra a sa�da da execu��o completa do c�digo criado para o exemplo. A aplica��o foi desenvolvida como uma aplica��o simples de console, mas o Joda Time pode ser utilizado em qualquer tipo de projeto Java, como um projeto Web ou um projeto EJB.

sa�da da execu��o aplica��o inteira — **Figura 8**. Sa�da da execu��o da aplica��o inteira

O Joda Time � um framework para a manipula��o de datas em Java, como at� a vers�o 7 do Java a API nativa para manipula��o de datas era bastante limitada, esse framework � bastante �til.

No Java 8, foi implementada uma nova API de datas, que foi totalmente baseada no Joda Time. Em projetos que j� utilizam o Java 8, talvez o Joda Time n�o seja necess�rio, mas ainda existem muitos projetos que n�o podem ser atualizados para a vers�o mais nova do Java, nesses projetos, o Joda Time ainda pode ser bastante �til.

Tecnologias:

Confira outros conte�dos:

Introdu��o ao JDBC

Novidades do Java

Teste unit�rio com JUnit

Assista grátis a nossa aula inaugural

Perguntas frequentes

Quem somos?

Por que a programação se tornou a profissão mais promissora da atualidade?

Como faço para começar a estudar?

Em quanto tempo de estudo vou me tornar um programador?

Sim, você pode se tornar um programador e não precisa ter diploma de curso superior!

O que eu irei aprender estudando pela DevMedia?

Principais diferenciais da DevMedia

Qual o investimento financeiro que preciso fazer para me tornar um programador?

Como funciona a forma de pagamento da DevMedia?

Por Eduardo Em 2014

Coment�rios nesta publica��o Escrever um coment�rio sobre conte�do

Valdecir Junior

N�vel 1

Muito bom!!

há +1 ano

Moderacao Devmedia

N�vel 0

Show que bom que gostou Valdeci.

Valeuuuuu.

há +1 ano

Jose Junior

N�vel 0

�timo artigo, parab�ns! Ser� de grande utilidade...

há +1 ano

Ver coment�rios anteriores (3)

Eduardo Santana

N�vel 0

Obrigado!

há +1 ano

Joao Moreira

N�vel 0

Muito bom!

há +1 ano

Nossos casos de sucesso

Leonardo Carlos

Eu sabia pouqu�ssimas coisas de programa��o antes de come�ar a estudar com voc�s, fui me especializando em v�rias �reas e ferramentas que tinham na plataforma, e com essa bagagem consegui um est�gio logo no in�cio do meu primeiro per�odo na faculdade.

Lucas Rodrigues

Estudo aqui na Dev desde o meio do ano passado! Nesse per�odo a Dev me ajudou a crescer muito aqui no trampo.
Fui o primeiro desenvolvedor contratado pela minha empresa. Hoje eu lidero um time de desenvolvimento!
Minha meta � continuar estudando e praticando para ser um Full-Stack Dev!

Her�clito J�nior

Economizei 3 meses para assinar a plataforma e sendo sincero valeu muito a pena, pois a plataforma � bem intuitiva e muuuuito did�tica a metodologia de ensino. Sinto que estou EVOLUINDO a cada dia. Muito obrigado!

Julio Cablen

Nossa! Plataforma maravilhosa. To amando o curso de desenvolvimento front-end, tinha coisas que eu ainda n�o tinha visto. A did�tica � do jeito que qualquer pessoa consegue aprender. S�rio, to apaixonado, adorando demais.

Joelberth Sena

Adquiri o curso de voc�s e logo percebi que s�o os melhores do Brasil. � um passo a passo incr�vel. S� n�o aprende quem n�o quer. Foi o melhor investimento da minha vida!

Felipe Nunes

Foi um dos melhores investimentos que j� fiz na vida e tenho aprendido bastante com a plataforma. Voc�s est�o fazendo parte da minha jornada nesse mundo da programa��o, irei assinar meu contrato como programador gra�as a plataforma.

Wanderson Oliveira

Comprei a assinatura tem uma semana, aprendi mais do que 4 meses estudando outros cursos. Exerc�cios pr�ticos que n�o tem como n�o aprender, est�o de parab�ns!

Jos� Lucas

Obrigado DevMedia, nunca presenciei uma plataforma de ensino t�o presente na vida acad�mica de seus alunos, parab�ns!

Eduardo Dorneles

Aprendi React na plataforma da DevMedia h� cerca de 1 ano e meio... Hoje estou h� 1 ano empregado trabalhando 100% com React!

Adauto Junior

J� fiz alguns cursos na �rea e nenhum � t�o bom quanto o de voc�s. Estou aprendendo muito, muito obrigado por existirem. Est�o de parab�ns... Espero um dia conseguir um emprego na �rea.

Ver todos os casos de sucesso

Manipulando Datas em Java com o framework Joda Time

Neste artigo vamos conhecer o Joda Time, que � um framework para a manipula��o de datas em Java. Como at� a vers�o 7 do Java a API nativa para manipula��o de datas era bastante limitada, esse framework � bastante �til.

Configura��o do Projeto

Exemplos de utiliza��o do Joda Time

Confira outros conte�dos:

Introdu��o ao JDBC

Novidades do Java

Teste unit�rio com JUnit

Perguntas frequentes

Nossos casos de sucesso