API de Data e Hora do Java 8

JavaBeginner
Pratique Agora

Introdução

O Java 8 introduziu a nova API de Data e Hora, que é inspirada na biblioteca JodaTime. Ela supera as desvantagens da API de Data existente. Neste laboratório, aprenderemos como usar a nova API de Data e Hora para manipular datas e horas.

Criando Instâncias de LocalDate

A classe LocalDate é usada para representar uma data no formato ISO padrão (aaaa-mm-dd). Ela não inclui tempo e não suporta fusos horários.

Podemos criar uma instância da classe LocalDate usando o método now(). Ele capturará a data atual de acordo com o relógio do sistema.

import java.time.LocalDate;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalDate currentDate = LocalDate.now();
        System.out.println("Current Date: " + currentDate);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

Current Date: 2021-08-13

Analisando uma String de Data

Podemos criar uma instância da classe LocalDate usando uma representação de string de uma data.

import java.time.LocalDate;

public class DateTimeExample {
    public static void main(String[] args) {
        String str = "2021-08-13";
        LocalDate date = LocalDate.parse(str);
        System.out.println("Date: " + date);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

Date: 2021-08-13

Métodos Plus e Minus

Podemos adicionar ou subtrair dias, meses ou anos de uma data usando os métodos plusDays() ou minusDays(). Também temos métodos semelhantes para alterar meses e anos.

import java.time.LocalDate;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalDate currDate = LocalDate.now();
        LocalDate yesterday = currDate.minusDays(1);
        LocalDate tomorrow = currDate.plusDays(1);

        System.out.println("Current Date: " + currDate);
        System.out.println("Tomorrow's Date: " + tomorrow);
        System.out.println("Yesterday's Date: " + yesterday);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

Current Date: 2021-08-13
Tomorrow's Date: 2021-08-14
Yesterday's Date: 2021-08-12

Métodos Getter

A classe LocalDate contém vários métodos getter para obter diferentes informações do LocalDate, como obter o dia da semana ou o dia do mês, etc.

import java.time.DayOfWeek;
import java.time.LocalDate;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalDate currDate = LocalDate.now();
        DayOfWeek dayOfWeek = currDate.getDayOfWeek();
        int dayOfMonth = currDate.getDayOfMonth();
        int dayOfYear = currDate.getDayOfYear();

        System.out.println("Date: " + currDate);
        System.out.println("Day of Week: " + dayOfWeek);
        System.out.println("Day of Month: " + dayOfMonth);
        System.out.println("Day of Year: " + dayOfYear);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

Date: 2021-08-13
Day of Week: FRIDAY
Day of Month: 13
Day of Year: 225

Comparando Datas

Podemos comparar datas usando os métodos isBefore() e isAfter() para verificar qual é maior.

import java.time.LocalDate;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalDate currDate = LocalDate.now();
        LocalDate tomorrow = currDate.plusDays(1);
        LocalDate yesterday = currDate.minusDays(1);

        System.out.println("Current date is after yesterday's date: " + currDate.isAfter(yesterday));
        System.out.println("Current date is before tomorrow's date: " + currDate.isBefore(tomorrow));
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

Current date is after yesterday's date: true
Current date is before tomorrow's date: true

Criando Instâncias LocalTime

Para criar uma instância de LocalTime, podemos usar o método now(), of() ou parse(). O método now() usará o relógio do sistema para obter a hora atual. Os métodos of() e parse() podem criar um LocalTime de acordo com os parâmetros passados.

import java.time.LocalTime;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalTime currentTime = LocalTime.now();
        LocalTime t1 = LocalTime.of(5, 32, 44);
        LocalTime t2 = LocalTime.parse("05:32:44");

        System.out.println(currentTime);
        System.out.println(t1);
        System.out.println(t2);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

17:43:08.749240
05:32:44
05:32:44

Métodos Plus e Minus

Podemos usar os métodos plus() e minus() para manipular instâncias de LocalTime.

import java.time.LocalTime;
import java.time.temporal.ChronoUnit;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalTime t1 = LocalTime.of(5, 32, 44);
        LocalTime t2 = t1.plus(2, ChronoUnit.HOURS);
        LocalTime t3 = t1.minusMinutes(10);

        System.out.println(t1);
        System.out.println(t2);
        System.out.println(t3);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

05:32:44
07:32:44
05:22:44

Criando Instâncias LocalDateTime

A classe LocalDateTime é uma combinação das classes LocalDate e LocalTime. Uma instância de LocalDateTime contém um componente de data e um componente de hora.

import java.time.LocalDateTime;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalDateTime currDateTime = LocalDateTime.now();
        LocalDateTime dt1 = LocalDateTime.of(2020, 8, 13, 5, 32);
        LocalDateTime dt2 = LocalDateTime.parse("2020-08-13T05:32");

        System.out.println(currDateTime);
        System.out.println(dt1);
        System.out.println(dt2);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

2021-08-13T17:46:48.837697
2020-08-13T05:32
2020-08-13T05:32

Trabalhando com Timezones

As classes discutidas acima não suportam fusos horários. A classe ZonedDateTime fornece essa funcionalidade. Podemos usar a classe ZoneId para identificar diferentes fusos horários.

import java.time.ZonedDateTime;
import java.time.ZoneId;

public class DateTimeExample {
    public static void main(String[] args) {
        ZonedDateTime zdt = ZonedDateTime.now();
        ZoneId zoneTokyo = ZoneId.of("Asia/Tokyo");
        ZonedDateTime zdtT = ZonedDateTime.now(zoneTokyo);
        ZoneId zoneLondon = ZoneId.of("Europe/London");
        ZonedDateTime zdtL = ZonedDateTime.now(zoneLondon);

        System.out.println(zdt);
        System.out.println(zdtT);
        System.out.println(zdtL);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

2021-08-13T18:09:25.352237+05:30[Asia/Calcutta]
2021-08-13T21:39:25.356244+09:00[Asia/Tokyo]
2021-08-13T13:09:25.357316+01:00[Europe/London]

Formatando Datas

Java 8 fornece uma função format() para formatar uma data em uma string usando um padrão específico.

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class DateTimeExample {
    public static void main(String[] args) {
        LocalDateTime dateTime = LocalDateTime.now();
        String dateStr1 = dateTime.format(DateTimeFormatter.ISO_WEEK_DATE);
        String dateStr2 = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE);
        String dateStr3 = dateTime.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME);
        String dateStr4 = dateTime.format(DateTimeFormatter.ofPattern("dd/MM/yyyy hh:mm:ss"));

        System.out.println(dateStr1);
        System.out.println(dateStr2);
        System.out.println(dateStr3);
        System.out.println(dateStr4);
    }
}

Salve e execute o código usando o seguinte comando:

javac DateTimeExample.java && java DateTimeExample

Veremos a saída abaixo:

2021-W32-5
20210813
2021-08-13T18:16:57.675704
13/08/2021 06:16:57

Resumo

Neste laboratório, aprendemos como usar a API de Data e Hora do Java 8 para manipular datas e horas. Aprendemos como criar instâncias das classes LocalDate, LocalTime e LocalDateTime, manipulá-las usando os métodos plus() e minus(), e obter informações delas usando métodos getter. Adicionalmente, aprendemos como trabalhar com fusos horários usando a classe ZonedDateTime e formatar datas usando a classe DateTimeFormatter.