Package com.github.brutils.javabrutils

Class DataUtil

java.lang.Object

com.github.brutils.javabrutils.DataUtil

public class DataUtil
extends Object

Classe para utilitários de datas.

Method Summary

Modifier and Type	Method	Description
static Date	adicionarAnos(Date data, int quantidadeDeAnos)	Adicionar uma quantidade de anos a uma data.
static Date	adicionarDias(Date data, int quantidadeDeDias)	Adicionar uma quantidade de dias a uma data.
static Date	adicionarMeses(Date data, int quantidadeDeMeses)	Adicionar uma quantidade de meses a uma data.
static List<String>	anos(int quantidadeRetroativa, int quantidadePosterior)	Método que retorna uma lista de anos, sendo o ano Corrente mais quantidadeRetroativa e Posterior.
static List<Integer>	anos(Integer anoInicial, int quantidadeRetroativa, int quantidadePosterior)	Método que retorna uma lista de anos, sendo o ano Inicial (Null para o Ano corrente) mais quantidadeRetroativa e Posterior.
static String	converterDataParaAnoMesDia(String data)	Converte uma data dd/MM/yy ou dd/MM/yyyy em yyyy/MM/dd.
static Date	data(int dia, int mes, int ano)	Converte os parâmetros em uma data.
static Date	dataAtual()	Retorna a data atual.
static String	dataAtualFormatada(String formatoDeSaida)	Retorna data atual no formato especificado.
static String	dataHoraParaString(Date data)	Método Converte uma Data válida numa String de data : dd/MM/yyyy às HH:mm.
static String	dateParaString(Date data)	Método Converte uma Data válida numa String de data : dd/MM/yyyy.
static String	dateParaString(Date data, String formatoDeSaida)	Método Converte uma Data válida em uma String de data de acordo formato de Saída.
static List<String>	dias()	Retorna uma lista de dias. Do dia 01 ao dia 31. Os dias estarão com dois dígitos.
static Integer	diasEntreDatas(Date dataInicial, Date dataFinal)	Retorna a quantidade de dias entre as datas passadas como parâmetro.
static Long	diferencaEntreDatas(Date dataInicial, Date dataFinal)	Retorna a diferença entre as datas passadas como parâmetro.
static String	formatarData(String data)	Método para formatar data yyyy-MM-dd em dd/MM/yyyy.
static String	formatarData(String data, String formatoDeEntrada)	Método para formatar data.
static String	formatarData(String data, String formatoDeEntrada, String formatoDeSaida)	Método para formatar data.
static List<String>	horas()	Retorna uma lista de String com as horas do dia.
static int	idade(Date dataAtual, Date dataDeNascimento)	Método para retornar a idade, em anos.
static int	idade(Date data, Date dataDeNascimento, String diaOuMes)	Método para retornar a idade, em anos.
boolean	isDataFormatoValido(String data)	Verifica se a data é válida.
static boolean	isDataValida(String data)	Método para verificar se é uma data válida.
static boolean	isDataValida(Date data)	Método para verificar se é uma data válida.
static String	mesComDoisDigitos(Integer mes)	Retorna o número do mês, com dois dígitos.
static List<String>	meses()	Retorna uma lista de meses.
static String	mesPorExtenso(Integer mes)	Método que retorna o nome do mês, de acordo com o número do mês passado por parâmetro.
static String	numeroMes(String mesDescricao)	Método que retorna o número do mês, de acordo com a descrição do mês passado por parâmetro.
static Date	removerAnos(Date data, int quantidadeDeAnos)	Remover uma quantidade de anos a uma data.
static Date	removerDias(Date data, int quantidadeDeDias)	Remover uma quantidade de dias de uma data.
static Date	removerMeses(Date data, int quantidadeDeMeses)	Remover uma quantidade de meses a uma data.
static Date	stringParaDate(String data)	Método Converte uma String no formato dd/mm/yyyy em uma data válida.
static Date	stringParaDate(String data, String formatoDeEntrada)	Método Converte uma String no formato passado como parâmetro (formatoDeEntrada) em uma data válida.
static Date	stringParaDate(String data, String formatoDeEntrada, String formatoDeSaida)	Método Converte uma String (formatoDeEntrada) em uma Data Válida.
static int	ultimoDiaDoMes(Integer ano, Integer mes)	Método que retorna o último dia do mês.
static int	ultimoDiaDoMes(Date data)	Método que retorna o último dia do mês de uma data.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

stringParaDate

public static Date stringParaDate(String data)
                           throws ParseException

Método Converte uma String no formato dd/mm/yyyy em uma data válida.
Retorna null se a data passada como parâmetro for "" ou null.

Parameters:

data - - Uma data do tipo String no formato dd/mm/yyyy.

Returns:

- A data convertida no tipo Date

Throws:

ParseException

stringParaDate

public static Date stringParaDate(String data,
                                  String formatoDeEntrada)
                           throws ParseException

Método Converte uma String no formato passado como parâmetro (formatoDeEntrada) em uma data válida.
A data passada como parâmetro será convertida para o formato dd/mm/yyyy.

Parameters:

data - - Uma data do tipo String no formato passado como parâmetro.

formatoDeEntrada - - Formato de entrada

Returns:

- A data convertida no tipo Date

Throws:

ParseException

stringParaDate

public static Date stringParaDate(String data,
                                  String formatoDeEntrada,
                                  String formatoDeSaida)
                           throws ParseException

Método Converte uma String (formatoDeEntrada) em uma Data Válida.

Parameters:

data - - Data

formatoDeEntrada - - Formato de entrada

formatoDeSaida - - Formato de saída

Returns:

data - String

Throws:

ParseException

dateParaString

public static String dateParaString(Date data)

Método Converte uma Data válida numa String de data : dd/MM/yyyy.

Parameters:

data - - Data

Returns:

data - String

dateParaString

public static String dateParaString(Date data,
                                    String formatoDeSaida)

Método Converte uma Data válida em uma String de data de acordo formato de Saída. The year formatter = new SimpleDateFormat("yy"); // 02 formatter = new SimpleDateFormat("yyyy"); // 2002 The month formatter = new SimpleDateFormat("M"); // 1 formatter = new SimpleDateFormat("MM"); // 01 formatter = new SimpleDateFormat("MMM"); // Jan formatter = new SimpleDateFormat("MMMM"); // January The day formatter = new SimpleDateFormat("d"); // 9 formatter = new SimpleDateFormat("dd"); // 09 The day in week formatter = new SimpleDateFormat("E"); // Wed formatter = new SimpleDateFormat("EEEE"); // Wednesday Time Format("yyyy.MM.dd.HH.mm.ss")

Parameters:

data - - Data

formatoDeSaida - - Formato de saída

Returns:

data - String

dataHoraParaString

public static String dataHoraParaString(Date data)

Método Converte uma Data válida numa String de data : dd/MM/yyyy às HH:mm.

Parameters:

data - - Data

Returns:

data - String

formatarData

public static String formatarData(String data,
                                  String formatoDeEntrada)
                           throws ParseException

Método para formatar data.

Parameters:

data - - Data

formatoDeEntrada - - Formato de entrada

Returns:

data

Throws:

ParseException

formatarData

public static String formatarData(String data)
                           throws ParseException

Método para formatar data yyyy-MM-dd em dd/MM/yyyy.

Parameters:

data - - Data

Returns:

data

Throws:

ParseException

formatarData

public static String formatarData(String data,
                                  String formatoDeEntrada,
                                  String formatoDeSaida)
                           throws ParseException

Método para formatar data.

Parameters:

data - - Data

formatoDeEntrada - - Formato de entrada

formatoDeSaida - - Formato de saída

Throws:

ParseException

dataAtualFormatada

public static String dataAtualFormatada(String formatoDeSaida)

Retorna data atual no formato especificado.

Parameters:

formatoDeSaida - - Formato de saída

Returns:

data

ultimoDiaDoMes

public static int ultimoDiaDoMes(Date data)

Método que retorna o último dia do mês de uma data.

Parameters:

data - - Data

Returns:

último dia do mês

ultimoDiaDoMes

public static int ultimoDiaDoMes(Integer ano,
                                 Integer mes)

Método que retorna o último dia do mês.

Parameters:

ano - - Ano

mes - - Mês

Returns:

último dia do mês

isDataValida

public static boolean isDataValida(String data)
                            throws ParseException

Método para verificar se é uma data válida.

Parameters:

data - - Data

Returns:

boolean

Throws:

ParseException

isDataValida

public static boolean isDataValida(Date data)

Método para verificar se é uma data válida.

Parameters:

data - - Data

Returns:

boolean

isDataFormatoValido

public boolean isDataFormatoValido(String data)

Verifica se a data é válida.

Parameters:

data - - Data

Returns:

true se a data for válida

adicionarDias

public static Date adicionarDias(Date data,
                                 int quantidadeDeDias)

Adicionar uma quantidade de dias a uma data.

Parameters:

data - - Data

quantidadeDeDias - - Quantidade de dias

Returns:

data

removerDias

public static Date removerDias(Date data,
                               int quantidadeDeDias)

Remover uma quantidade de dias de uma data.

Parameters:

data - - Data

quantidadeDeDias - - Quantidade de dias

Returns:

data

adicionarMeses

public static Date adicionarMeses(Date data,
                                  int quantidadeDeMeses)

Adicionar uma quantidade de meses a uma data.

Parameters:

data - - Data

quantidadeDeMeses - - Quantidade de meses

Returns:

data

removerMeses

public static Date removerMeses(Date data,
                                int quantidadeDeMeses)

Remover uma quantidade de meses a uma data.

Parameters:

data - - Data

quantidadeDeMeses - - Quantidade de meses

Returns:

data

adicionarAnos

public static Date adicionarAnos(Date data,
                                 int quantidadeDeAnos)

Adicionar uma quantidade de anos a uma data.

Parameters:

data - - Data

quantidadeDeAnos - - Quantidade de anos

Returns:

data

removerAnos

public static Date removerAnos(Date data,
                               int quantidadeDeAnos)

Remover uma quantidade de anos a uma data.

Parameters:

data - - Data

quantidadeDeAnos - - Quantidade de anos

Returns:

data

data

public static Date data(int dia,
                        int mes,
                        int ano)

Converte os parâmetros em uma data.

Parameters:

dia - - Dia

mes - - Mês

ano - - Ano

Returns:

data

mesComDoisDigitos

public static String mesComDoisDigitos(Integer mes)

Retorna o número do mês, com dois dígitos.

Parameters:

mes - - Mês

Returns:

mês

horas

public static List<String> horas()

Retorna uma lista de String com as horas do dia.
Intervalo de 30 minutos.

Returns:

String

anos

public static List<String> anos(int quantidadeRetroativa,
                                int quantidadePosterior)

Método que retorna uma lista de anos, sendo o ano Corrente mais quantidadeRetroativa e Posterior.

Parameters:

quantidadeRetroativa - - Quantidade retroativa

quantidadePosterior - - Quantidade posterior

Returns:

lista de anos

anos

public static List<Integer> anos(Integer anoInicial,
                                 int quantidadeRetroativa,
                                 int quantidadePosterior)

Método que retorna uma lista de anos, sendo o ano Inicial (Null para o Ano corrente) mais quantidadeRetroativa e Posterior.

Parameters:

anoInicial - - Ano inicial

quantidadeRetroativa - - Quantidade retroativa

quantidadePosterior - - Quantidade posterior

Returns:

lista de anos

meses

public static List<String> meses()

Retorna uma lista de meses.

Returns:

lista de meses

dias

public static List<String> dias()

Retorna uma lista de dias.
Do dia 01 ao dia 31.
Os dias estarão com dois dígitos. Ex: 01,02,...,30,31.

Returns:

lista de dias

mesPorExtenso

public static String mesPorExtenso(Integer mes)

Método que retorna o nome do mês, de acordo com o número do mês passado por parâmetro.

Parameters:

mes - - Mês

Returns:

nome do mês

numeroMes

public static String numeroMes(String mesDescricao)

Método que retorna o número do mês, de acordo com a descrição do mês passado por parâmetro.

Parameters:

mesDescricao - - Descrição do mês

Returns:

número do mês

diasEntreDatas

public static Integer diasEntreDatas(Date dataInicial,
                                     Date dataFinal)

Retorna a quantidade de dias entre as datas passadas como parâmetro.

Parameters:

dataInicial - - Data inicial

dataFinal - - Data final

Returns:

quantidade de dias

diferencaEntreDatas

public static Long diferencaEntreDatas(Date dataInicial,
                                       Date dataFinal)

Retorna a diferença entre as datas passadas como parâmetro.

Parameters:

dataInicial - - Data inicial

dataFinal - - Data final

Returns:

diferença

idade

public static int idade(Date data,
                        Date dataDeNascimento,
                        String diaOuMes)

Método para retornar a idade, em anos.

Parameters:

data - - Data

dataDeNascimento - - Data de nascimento

diaOuMes - - Dia ou mês

Returns:

idade

idade

public static int idade(Date dataAtual,
                        Date dataDeNascimento)

Método para retornar a idade, em anos.

Parameters:

dataAtual - - Data atual

dataDeNascimento - - Data de nascimento

Returns:

idade

dataAtual

public static Date dataAtual()

Retorna a data atual.

Returns:

data atual

See Also:

stringParaDate(String)

converterDataParaAnoMesDia

public static String converterDataParaAnoMesDia(String data)
                                         throws ParseException

Converte uma data dd/MM/yy ou dd/MM/yyyy em yyyy/MM/dd.

Parameters:

data - - Data no formato dd/MM/yy ou dd/MM/yyyy

Returns:

data no formato yyyy/MM/dd

Throws:

ParseException