Java 8: A Nova API Robusta de Data e Hora

Com o Java 8, uma nova API de Data-Hora foi introduzida para superar as deficiências da API antiga:

Não thread-safe — java.util.Date não é thread-safe, exigindo tratamento de concorrência. A nova API é imutável e não possui métodos setter.
Design ruim — Ano padrão começava em 1900, mês em 1 e dia em 0, sem uniformidade. A nova API oferece inúmeros métodos utilitários para operações de data.
Tratamento de fuso horário difícil — Desenvolvedores escreviam muito código para lidar com fusos. A nova API foi projetada com design orientado a domínio.

O Java 8 introduz a nova API sob o pacote java.time. Classes importantes:

Local — API simplificada sem complexidade de fuso horário.
Zoned — API especializada para lidar com diversos fusos horários.

API Local Date-Time

As classes LocalDate, LocalTime e LocalDateTime simplificam o desenvolvimento onde fusos não são necessários. Veja em ação:

Java8Tester.java

import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;
import java.time.Month;

public class Java8Tester {
    public static void main(String args[]) {
        Java8Tester java8tester = new Java8Tester();
        java8tester.testLocalDateTime();
    }

    public void testLocalDateTime() {
        // Data e hora atuais
        LocalDateTime currentTime = LocalDateTime.now();
        System.out.println("DataHora atual: " + currentTime);

        LocalDate date1 = currentTime.toLocalDate();
        System.out.println("date1: " + date1);

        Month month = currentTime.getMonth();
        int day = currentTime.getDayOfMonth();
        int seconds = currentTime.getSecond();
        System.out.println("Mês: " + month + " dia: " + day + " segundos: " + seconds);

        // Manipulação: dia 10, ano 2012
        LocalDateTime date2 = currentTime.withDayOfMonth(10).withYear(2012);
        System.out.println("date2: " + date2);

        // 12 de dezembro de 2014
        LocalDate date3 = LocalDate.of(2014, Month.DECEMBER, 12);
        System.out.println("date3: " + date3);

        // 22:15
        LocalTime date4 = LocalTime.of(22, 15);
        System.out.println("date4: " + date4);

        // Parse de string
        LocalTime date5 = LocalTime.parse("20:15:30");
        System.out.println("date5: " + date5);
    }
}

Verificando o Resultado

C:\JAVA>javac Java8Tester.java
C:\JAVA>java Java8Tester

Saída (exemplo):

DataHora atual: 2014-12-09T11:00:45.457
date1: 2014-12-09
Mês: DECEMBER dia: 9 segundos: 45
date2: 2012-12-10T11:00:45.457
date3: 2014-12-12
date4: 22:15
date5: 20:15:30

API Zoned Date-Time

Use quando o fuso horário for relevante.

Java8Tester.java

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

public class Java8Tester {
    public static void main(String args[]) {
        Java8Tester java8tester = new Java8Tester();
        java8tester.testZonedDateTime();
    }

    public void testZonedDateTime() {
        ZonedDateTime date1 = ZonedDateTime.parse("2007-12-03T10:15:30+05:30[Asia/Karachi]");
        System.out.println("date1: " + date1);

        ZoneId id = ZoneId.of("Europe/Paris");
        System.out.println("ZoneId: " + id);

        ZoneId currentZone = ZoneId.systemDefault();
        System.out.println("CurrentZone: " + currentZone);
    }
}

Verificando o Resultado

C:\JAVA>javac Java8Tester.java
C:\JAVA>java Java8Tester

Saída (exemplo):

date1: 2007-12-03T10:15:30+05:00[Asia/Karachi]
ZoneId: Europe/Paris
CurrentZone: Etc/UTC

Enum ChronoUnit

java.time.temporal.ChronoUnit substitui valores inteiros usados na API antiga para representar dia, mês, etc.

Java8Tester.java

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class Java8Tester {
    public static void main(String args[]) {
        Java8Tester java8tester = new Java8Tester();
        java8tester.testChromoUnits();
    }

    public void testChromoUnits() {
        LocalDate today = LocalDate.now();
        System.out.println("Data atual: " + today);

        LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
        System.out.println("Próxima semana: " + nextWeek);

        LocalDate nextMonth = today.plus(1, ChronoUnit.MONTHS);
        System.out.println("Próximo mês: " + nextMonth);

        LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
        System.out.println("Próximo ano: " + nextYear);

        LocalDate nextDecade = today.plus(1, ChronoUnit.DECADES);
        System.out.println("Daqui a dez anos: " + nextDecade);
    }
}

Verificando o Resultado

C:\JAVA>javac Java8Tester.java
C:\JAVA>java Java8Tester

Saída (exemplo):

Data atual: 2014-12-10
Próxima semana: 2014-12-17
Próximo mês: 2015-01-10
Próximo ano: 2015-12-10
Daqui a dez anos: 2024-12-10

Period e Duration

Duas classes especializadas para diferenças de tempo:

Period — lida com quantidade de tempo baseada em data.
Duration — lida com quantidade de tempo baseada em hora.

Java8Tester.java

import java.time.temporal.ChronoUnit;
import java.time.LocalDate;
import java.time.LocalTime;
import java.time.Duration;
import java.time.Period;

public class Java8Tester {
    public static void main(String args[]) {
        Java8Tester java8tester = new Java8Tester();
        java8tester.testPeriod();
        java8tester.testDuration();
    }

    public void testPeriod() {
        LocalDate date1 = LocalDate.now();
        System.out.println("Data atual: " + date1);

        LocalDate date2 = date1.plus(1, ChronoUnit.MONTHS);
        System.out.println("Próximo mês: " + date2);

        Period period = Period.between(date2, date1);
        System.out.println("Period: " + period);
    }

    public void testDuration() {
        LocalTime time1 = LocalTime.now();
        Duration twoHours = Duration.ofHours(2);
        LocalTime time2 = time1.plus(twoHours);
        Duration duration = Duration.between(time1, time2);
        System.out.println("Duration: " + duration);
    }
}

Verificando o Resultado

C:\JAVA>javac Java8Tester.java
C:\JAVA>java Java8Tester

Saída (exemplo):

Data atual: 2014-12-10
Próximo mês: 2015-01-10
Period: P-1M
Duration: PT2H

Ajustadores Temporais (Temporal Adjusters)

TemporalAdjuster realiza cálculos de data, como "segundo sábado do mês" ou "próxima terça-feira".

Java8Tester.java

import java.time.LocalDate;
import java.time.temporal.TemporalAdjusters;
import java.time.DayOfWeek;

public class Java8Tester {
    public static void main(String args[]) {
        Java8Tester java8tester = new Java8Tester();
        java8tester.testAdjusters();
    }

    public void testAdjusters() {
        LocalDate date1 = LocalDate.now();
        System.out.println("Data atual: " + date1);

        // Próxima terça-feira
        LocalDate nextTuesday = date1.with(TemporalAdjusters.next(DayOfWeek.TUESDAY));
        System.out.println("Próxima terça-feira em: " + nextTuesday);

        // Segundo sábado do próximo mês
        LocalDate firstInYear = LocalDate.of(date1.getYear(), date1.getMonth(), 1);
        LocalDate secondSaturday = firstInYear.with(TemporalAdjusters.nextOrSame(DayOfWeek.SATURDAY))
                                             .with(TemporalAdjusters.next(DayOfWeek.SATURDAY));
        System.out.println("Segundo sábado em: " + secondSaturday);
    }
}

Verificando o Resultado

C:\JAVA>javac Java8Tester.java
C:\JAVA>java Java8Tester

Saída (exemplo):

Data atual: 2014-12-10
Próxima terça-feira em: 2014-12-16
Segundo sábado em: 2014-12-13

Compatibilidade com Versões Anteriores

O método toInstant() foi adicionado a Date e Calendar para conversão para a nova API. Use ofInstant(Instant, ZoneId) para obter LocalDateTime ou ZonedDateTime.

Java8Tester.java

import java.time.LocalDateTime;
import java.time.ZonedDateTime;
import java.util.Date;
import java.time.Instant;
import java.time.ZoneId;

public class Java8Tester {
    public static void main(String args[]) {
        Java8Tester java8tester = new Java8Tester();
        java8tester.testBackwardCompatability();
    }

    public void testBackwardCompatability() {
        Date currentDate = new Date();
        System.out.println("Data atual: " + currentDate);

        Instant now = currentDate.toInstant();
        ZoneId currentZone = ZoneId.systemDefault();

        LocalDateTime localDateTime = LocalDateTime.ofInstant(now, currentZone);
        System.out.println("Data local: " + localDateTime);

        ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(now, currentZone);
        System.out.println("Data com fuso: " + zonedDateTime);
    }
}

Verificando o Resultado

C:\JAVA>javac Java8Tester.java
C:\JAVA>java Java8Tester

Saída (exemplo):

Data atual: Wed Dec 10 05:44:06 UTC 2014
Data local: 2014-12-10T05:44:06.635
Data com fuso: 2014-12-10T05:44:06.635Z[Etc/UTC]

Java 8 Nashorn: Motor JavaScript de Alto Desempenho e Ferramenta jjs Java 8 Base64: Codificação Simple, URL e MIME Simplificada

Java