Skip to main content
adicionou 48 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170

Repare que cada um dos formatos acima é diferente, mas todos representam a mesma data (os mesmos valores numéricos do dia, mês e ano).

Repare que cada um dos formatos acima é diferente, mas todos representam a mesma data.

Repare que cada um dos formatos acima é diferente, mas todos representam a mesma data (os mesmos valores numéricos do dia, mês e ano).

adicionou 272 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170

Se você "retornar a data no formato dd/MM/yyyy", ela deixa de ser uma data (um LocalDate) e vira uma String. Para entender melhor, segue abaixo uma - longa - explicação.

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy"uuuu");
LocalDate dt1 = LocalDate.parse("15/03/1990", formatter);
System.out.println(dt1); // 1990-03-15

LocalDate dt2 = LocalDate.of(1990, 3, 15);
System.out.println(dt2); // 1990-03-15

System.out.println(dt1.equals(dt2)); // true

dt2 foi criada usando-se os valores numéricos diretamente. Ela também só possui os valores, e não tem nenhuma informação quanto ao formato. Tanto que dt1 e dt2 são iguais (correspondem à mesma data - ao mesmo ponto do calendário - os seus valores numéricos do dia, mês e ano são iguais): veja na última linha que dt1.equals(dt2) imprime true).

Outro detalhe - que você já deve ter percebido - é usar uuuu para o ano, em vez de yyyy. De maneira bem resumida, u funciona tanto para anos atuais quanto para datas A.C. (Antes de Cristo), aceitando anos negativos, enquanto y precisa da era (A.C. ou B.C.) para decidir se ano é Antes ou Depois de Cristo (no parsing não vemos esses problemas porque a era é inferida e para datas atuais funciona normalmente).

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate dt1 = LocalDate.parse("15/03/1990", formatter);
System.out.println(dt1); // 1990-03-15

LocalDate dt2 = LocalDate.of(1990, 3, 15);
System.out.println(dt2); // 1990-03-15

System.out.println(dt1.equals(dt2)); // true

dt2 foi criada usando-se os valores numéricos diretamente. Ela também só possui os valores, e não tem nenhuma informação quanto ao formato. Tanto que dt1 e dt2 são iguais (correspondem à mesma data - ao mesmo ponto do calendário): veja na última linha que dt1.equals(dt2) imprime true).

Outro detalhe é usar uuuu para o ano, em vez de yyyy. De maneira bem resumida, u funciona tanto para anos atuais quanto para datas A.C. (Antes de Cristo), aceitando anos negativos, enquanto y precisa da era (A.C. ou B.C.) para decidir se ano é Antes ou Depois de Cristo (no parsing não vemos esses problemas porque a era é inferida e para datas atuais funciona normalmente).

Se você "retornar a data no formato dd/MM/yyyy", ela deixa de ser uma data (um LocalDate) e vira uma String. Para entender melhor, segue abaixo uma - longa - explicação.

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");
LocalDate dt1 = LocalDate.parse("15/03/1990", formatter);
System.out.println(dt1); // 1990-03-15

LocalDate dt2 = LocalDate.of(1990, 3, 15);
System.out.println(dt2); // 1990-03-15

System.out.println(dt1.equals(dt2)); // true

dt2 foi criada usando-se os valores numéricos diretamente. Ela também só possui os valores, e não tem nenhuma informação quanto ao formato. Tanto que dt1 e dt2 são iguais (correspondem à mesma data - ao mesmo ponto do calendário - os seus valores numéricos do dia, mês e ano são iguais): veja na última linha que dt1.equals(dt2) imprime true.

Outro detalhe - que você já deve ter percebido - é usar uuuu para o ano, em vez de yyyy. De maneira bem resumida, u funciona tanto para anos atuais quanto para datas A.C. (Antes de Cristo), aceitando anos negativos, enquanto y precisa da era (A.C. ou B.C.) para decidir se ano é Antes ou Depois de Cristo (no parsing não vemos esses problemas porque a era é inferida e para datas atuais funciona normalmente).

adicionou 4284 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170

A data de "15 de março de 1990" representa isso: o ponto específico do calendário, ocorrido há vários anos atrás, que convencionamos chamar de dia 15 do mês de março do ano de 1990. Para expressar essa ideia em forma de texto, eu posso escrevê-la de diferentes formas:

  • 15/03/1990 (um formato bem comum em muitos países, incluindo o Brasil)
  • 3/15/1990 (o terrível formatoformato americano, invertendo o dia e mês)
  • 1990-03-15 (o formato ISO 8601)
  • 15 de março de 1990 (em bom português)
  • March, 15th, 1990 (em inglês)
  • 1990年3月15日 (em japonês)
  • e muitos outros...

De maneira similar, em Java temos a classe LocalDate, que implementa o conceito de uma data (um dia, mês e ano específicos), e temos a classe String, que pode conter um texto que representa uma data (qualquer um dos formatos acima, e qualquer outro que você quiser).

Um LocalDate, por si só, não possui nenhum formato específico. Internamente, esta classe possui apenas 3 valores numéricosapenas 3 valores numéricos: o dia, mês e ano.

Quando você imprime um LocalDate (seja com System.out.println, com uma API de log, ou até mesmo vendo seu valor em um debugger), internamente é chamado o método toString(), que retorna os valores do dia, mês e ano formatados em uma String. No caso da API java.time, optou-se por retornar esta String no formato ISO 8601 (por isso a data é mostrada como 1990-03-15).

Ou seja, ao fazer System.out.println(dt1), você vê o retorno do método toString(), que retorna os valores da data em um formato específico (em uma String). Mas isso não quer dizer que o LocalDate estáestá naquele formato. Na verdade, ele não está em formato nenhum, pois ele sequer possui um.

Apenas para exemplificar:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate dt1 = LocalDate.parse("15/03/1990", formatter);
System.out.println(dt1); // 1990-03-15

LocalDate dt2 = LocalDate.of(1990, 3, 15);
System.out.println(dt2); // 1990-03-15

System.out.println(dt1.equals(dt2)); // true

A primeira data (dt1) foi criada a partir de uma String. Como esta String representa uma data no formato "dia/mês/ano", eu usei o DateTimeFormatter com esse formato e fiz o parse para obter o LocalDate. Então agora dt1 corresponde a "15 de março de 1990".

Mas internamente dt1 não possui nenhum formato. Ela possui somente os valores numéricos (dia 15, mês 3 e ano 1990). dt1 não sabe que esses valores vieram de uma String (quem fez essa correspondência entre o que estava na String e os valores numéricos foi o DateTimeFormatter).

É claro que, ao imprimir dt1, ela tem que ser mostrada de algum jeito, e o seu método toString() acaba mostrando no formato ISO 8601. Mas isso não quer dizer que dt1 está naquele formato.

dt2 foi criada usando-se os valores numéricos diretamente. Ela também só possui os valores, e não tem nenhuma informação quanto ao formato. Tanto que dt1 e dt2 são iguais (correspondem à mesma data - ao mesmo ponto do calendário): veja na última linha que dt1.equals(dt2) imprime true).

ResumindoSendo assim, sevocê deve decidir o que precisa em cada ponto do código.

Se o método setInicioMandato recebe um LocalDate como parâmetro, basta passá-lo diretamente, sem se preocupar com o formato (até porque o LocalDate não tem nenhum formato, somente os valores numéricos do dia, mês e ano).

Se você quer mostrar a data em algum formato diferente, aí é o caso de convertê-la para String, usando um DateTimeFormatter.


Bônus

Apenas para complementar, veja o que acontece se a String tiver datas como 31 de abril ou 29 de fevereiro em anos não bissextos:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");
LocalDate dt1 = LocalDate.parse("31/04/2019", formatter);
System.out.println(dt1); // 2019-04-30
LocalDate dt2 = LocalDate.parse("29/02/2019", formatter);
System.out.println(dt2); // 2019-02-28

31 de abril é inválido, pois abril só tem 30 dias. Mas 31/04/2019 foi aceito e ajustado para 30 de abril.29/02/2019 (que também é inválido, pois 2019 não é ano bissexto) foi ajustado para 28 de fevereiro.

Se quiser evitar essas situações e aceitar somente datas válidas, basta mudar o java.time.format.ResolverStyle, usando o valor STRICT (conforme sugerido nesta resposta). Com isso, datas inválidas lançam uma exceção:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu")
    .withResolverStyle(ResolverStyle.STRICT);
LocalDate dt1 = LocalDate.parse("31/04/2019", formatter);

O código acima tenta fazer o Se você quer mostrar a data em algum formato diferente, aí é o caso de convertê-la para String, usando um DateTimeFormatterparsing de uma data inválida, mas devido ao ResolverStyle.STRICT, ele lança uma exceção:

java.time.format.DateTimeParseException: Text '31/04/2019' could not be parsed: Unable to obtain LocalDate from TemporalAccessor: {YearOfEra=2019, MonthOfYear=4, DayOfMonth=31},ISO of type java.time.format.Parsed

Outro detalhe é usar uuuu para o ano, em vez de yyyy. De maneira bem resumida, u funciona tanto para anos atuais quanto para datas A.C. (Antes de Cristo), aceitando anos negativos, enquanto y precisa da era (A.C. ou B.C.) para decidir se ano é Antes ou Depois de Cristo (no parsing não vemos esses problemas porque a era é inferida e para datas atuais funciona normalmente).

Talvez o uso de datas tão antigas não seja tão comum em muitas aplicações, mas de qualquer forma, o uso de u em vez de y é recomendado. Para mais detalhes, veja esta pergunta no Stack Overflow em inglês.

A data de "15 de março de 1990" representa isso: o dia 15 do mês de março do ano de 1990. Para expressar essa ideia em forma de texto, eu posso escrevê-la de diferentes formas:

  • 15/03/1990 (um formato bem comum em muitos países, incluindo o Brasil)
  • 3/15/1990 (o terrível formato americano, invertendo o dia e mês)
  • 1990-03-15 (o formato ISO 8601)
  • 15 de março de 1990 (em bom português)
  • March, 15th 1990 (em inglês)
  • 1990年3月15日 (em japonês)
  • e muitos outros...

De maneira similar, em Java temos a classe LocalDate, que implementa o conceito de uma data, e temos a classe String, que pode conter um texto que representa uma data.

LocalDate, por si só, não possui nenhum formato específico. Internamente, esta classe possui apenas 3 valores numéricos: o dia, mês e ano.

Quando você imprime um LocalDate (seja com System.out.println, com uma API de log, ou até mesmo vendo seu valor em um debugger), internamente é chamado o método toString(), que retorna os valores do dia, mês e ano formatados em uma String. No caso da API java.time, optou-se por retornar esta String no formato ISO 8601.

Ou seja, ao fazer System.out.println(dt1), você vê o retorno do método toString(), que retorna os valores da data em um formato específico. Mas isso não quer dizer que o LocalDate está naquele formato. Na verdade, ele não está em formato nenhum, pois ele sequer possui um.

Resumindo, se o método setInicioMandato recebe um LocalDate como parâmetro, basta passá-lo diretamente, sem se preocupar com o formato.

Se você quer mostrar a data em algum formato diferente, aí é o caso de convertê-la para String, usando um DateTimeFormatter.

A data de "15 de março de 1990" representa isso: o ponto específico do calendário, ocorrido há vários anos atrás, que convencionamos chamar de dia 15 do mês de março do ano de 1990. Para expressar essa ideia em forma de texto, eu posso escrevê-la de diferentes formas:

  • 15/03/1990 (um formato bem comum em muitos países, incluindo o Brasil)
  • 3/15/1990 (formato americano, invertendo o dia e mês)
  • 1990-03-15 (o formato ISO 8601)
  • 15 de março de 1990 (em bom português)
  • March 15th, 1990 (em inglês)
  • 1990年3月15日 (em japonês)
  • e muitos outros...

De maneira similar, em Java temos a classe LocalDate, que implementa o conceito de uma data (um dia, mês e ano específicos), e temos a classe String, que pode conter um texto que representa uma data (qualquer um dos formatos acima, e qualquer outro que você quiser).

Um LocalDate, por si só, não possui nenhum formato específico. Internamente, esta classe possui apenas 3 valores numéricos: o dia, mês e ano.

Quando você imprime um LocalDate (seja com System.out.println, com uma API de log, ou até mesmo vendo seu valor em um debugger), internamente é chamado o método toString(), que retorna os valores do dia, mês e ano formatados em uma String. No caso da API java.time, optou-se por retornar esta String no formato ISO 8601 (por isso a data é mostrada como 1990-03-15).

Ou seja, ao fazer System.out.println(dt1), você vê o retorno do método toString(), que retorna os valores da data em um formato específico (em uma String). Mas isso não quer dizer que o LocalDate está naquele formato. Na verdade, ele não está em formato nenhum, pois ele sequer possui um.

Apenas para exemplificar:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate dt1 = LocalDate.parse("15/03/1990", formatter);
System.out.println(dt1); // 1990-03-15

LocalDate dt2 = LocalDate.of(1990, 3, 15);
System.out.println(dt2); // 1990-03-15

System.out.println(dt1.equals(dt2)); // true

A primeira data (dt1) foi criada a partir de uma String. Como esta String representa uma data no formato "dia/mês/ano", eu usei o DateTimeFormatter com esse formato e fiz o parse para obter o LocalDate. Então agora dt1 corresponde a "15 de março de 1990".

Mas internamente dt1 não possui nenhum formato. Ela possui somente os valores numéricos (dia 15, mês 3 e ano 1990). dt1 não sabe que esses valores vieram de uma String (quem fez essa correspondência entre o que estava na String e os valores numéricos foi o DateTimeFormatter).

É claro que, ao imprimir dt1, ela tem que ser mostrada de algum jeito, e o seu método toString() acaba mostrando no formato ISO 8601. Mas isso não quer dizer que dt1 está naquele formato.

dt2 foi criada usando-se os valores numéricos diretamente. Ela também só possui os valores, e não tem nenhuma informação quanto ao formato. Tanto que dt1 e dt2 são iguais (correspondem à mesma data - ao mesmo ponto do calendário): veja na última linha que dt1.equals(dt2) imprime true).

Sendo assim, você deve decidir o que precisa em cada ponto do código.

Se o método setInicioMandato recebe um LocalDate como parâmetro, basta passá-lo diretamente, sem se preocupar com o formato (até porque o LocalDate não tem nenhum formato, somente os valores numéricos do dia, mês e ano).

Se você quer mostrar a data em algum formato diferente, aí é o caso de convertê-la para String, usando um DateTimeFormatter.


Bônus

Apenas para complementar, veja o que acontece se a String tiver datas como 31 de abril ou 29 de fevereiro em anos não bissextos:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");
LocalDate dt1 = LocalDate.parse("31/04/2019", formatter);
System.out.println(dt1); // 2019-04-30
LocalDate dt2 = LocalDate.parse("29/02/2019", formatter);
System.out.println(dt2); // 2019-02-28

31 de abril é inválido, pois abril só tem 30 dias. Mas 31/04/2019 foi aceito e ajustado para 30 de abril.29/02/2019 (que também é inválido, pois 2019 não é ano bissexto) foi ajustado para 28 de fevereiro.

Se quiser evitar essas situações e aceitar somente datas válidas, basta mudar o java.time.format.ResolverStyle, usando o valor STRICT (conforme sugerido nesta resposta). Com isso, datas inválidas lançam uma exceção:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu")
    .withResolverStyle(ResolverStyle.STRICT);
LocalDate dt1 = LocalDate.parse("31/04/2019", formatter);

O código acima tenta fazer o parsing de uma data inválida, mas devido ao ResolverStyle.STRICT, ele lança uma exceção:

java.time.format.DateTimeParseException: Text '31/04/2019' could not be parsed: Unable to obtain LocalDate from TemporalAccessor: {YearOfEra=2019, MonthOfYear=4, DayOfMonth=31},ISO of type java.time.format.Parsed

Outro detalhe é usar uuuu para o ano, em vez de yyyy. De maneira bem resumida, u funciona tanto para anos atuais quanto para datas A.C. (Antes de Cristo), aceitando anos negativos, enquanto y precisa da era (A.C. ou B.C.) para decidir se ano é Antes ou Depois de Cristo (no parsing não vemos esses problemas porque a era é inferida e para datas atuais funciona normalmente).

Talvez o uso de datas tão antigas não seja tão comum em muitas aplicações, mas de qualquer forma, o uso de u em vez de y é recomendado. Para mais detalhes, veja esta pergunta no Stack Overflow em inglês.

Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
Carregando