Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Interpretar, criar e formatar datas e datas com hora em Java

Cria datas a partir de campos, interpreta texto ISO ou com um padrão próprio e formata datas com ou sem hora, sem lhes atribuir um fuso horário.

Versão: Java SE 21

Sintaxe

Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter

Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.

Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTime

Em java.time, LocalDate representa apenas uma data ISO, enquanto LocalDateTime combina uma data ISO com uma hora local. Nenhum dos tipos guarda um fuso horário ou um desvio em relação a UTC, nem identifica por si só um instante único. Ambos os tipos são imutáveis.

LocalDate.of(year, month, dayOfMonth) é um método de fábrica estático que aceita um número de mês de 1 a 12 ou uma constante Month. O método de fábrica estático LocalDateTime.of(date, time) combina um LocalDate com um LocalTime. As sobrecargas que recebem campos aceitam um número de mês ou um Month, exigem a hora e o minuto e permitem acrescentar o segundo e depois o nanossegundo. Um segundo ou nanossegundo omitido vale zero. Valores de campo inválidos, como 29 de fevereiro num ano não bissexto, provocam uma DateTimeException.

O método estático LocalDate.parse(text) utiliza DateTimeFormatter.ISO_LOCAL_DATE, por exemplo para 2024-02-29. A sobrecarga LocalDate.parse(text, formatter) utiliza o formatador indicado, por exemplo com o padrão dd/MM/uuuu. Se o texto não puder ser interpretado como data, é lançada uma DateTimeParseException. Por omissão, DateTimeFormatter.ofPattern utiliza SMART, que pode ajustar 29/02/2023 para 28 de fevereiro. Para rejeitar estas datas, define ResolverStyle.STRICT e usa uuuu (ano), não yyyy (ano da era).

Os métodos de instância LocalDate.format(formatter) e LocalDateTime.format(formatter) devolvem uma String usando o formatador indicado sem alterar o valor. Se faltar um campo obrigatório, como a hora pedida por HH:mm num LocalDate, a formatação lança DateTimeException. LocalDate.toString() não recebe um formatador e devolve texto ISO-8601, como 2024-02-29. Os padrões distinguem maiúsculas de minúsculas: MM é o mês, mm é o minuto e HH é a hora no formato de 24 horas.

Exemplos

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DateTimeFormatter dateFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);
        DateTimeFormatter dateTimeFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);

        LocalDate date = LocalDate.of(2024, 2, 29);
        LocalDate fromIso = LocalDate.parse("2024-02-29");
        LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);

        System.out.println(date.equals(fromIso) && date.equals(fromCustom));
        System.out.println(date.toString());
        System.out.println(date.format(dateFormat));

        LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
        System.out.println(dateTime.format(dateTimeFormat));

        try {
            LocalDate.parse("29/02/2023", dateFormat);
            System.out.println("Unexpected success");
        } catch (DateTimeParseException e) {
            System.out.println("Invalid date rejected");
        }
    }
}

Resultado

true
2024-02-29
29/02/2024
29/02/2024 09:05
Invalid date rejected

A primeira linha confirma que ambos os valores lidos são iguais à data criada pelo método de fábrica. As três seguintes mostram a data ISO, a data com o formato personalizado e a data com hora. A última mostra que a interpretação estrita rejeita 29 de fevereiro de 2023.

Lições relacionadas

  • Java · Lição 61 · Avançado · Versão: 2

Fontes