Java 8 : La nouvelle API Date/Time robuste et moderne

Java 8 introduit une toute nouvelle API Date-Heure (java.time) pour pallier les défauts de l'ancienne API (java.util.Date, Calendar) :

• Non thread-safe : java.util.Date n'est pas thread-safe. La nouvelle API est immuable et sans setters.

• Conception maladroite : Année dès 1900, mois à partir de 1, jour à partir de 0. La nouvelle API offre des méthodes utilitaires cohérentes.

• Gestion des fuseaux horaire complexe : L'ancienne API nécessitait beaucoup de code. La nouvelle a été conçue avec une approche domaine-specific.

Les classes principales sous java.time :

• Local : API simplifiée sans complexité de fuseau horaire (LocalDate, LocalTime, LocalDateTime).

• Zoned : API spécialisée pour les fuseaux horaires (ZonedDateTime, ZoneId).

API Local Date-Time

LocalDate, LocalTime et LocalDateTime simplifient le développement sans fuseau horaire.

Exemple : 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() {
        LocalDateTime currentTime = LocalDateTime.now();
        System.out.println("DateHeure actuelle : " + 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("Mois : " + month + " jour : " + day + " secondes : " + seconds);

        LocalDateTime date2 = currentTime.withDayOfMonth(10).withYear(2012);
        System.out.println("date2 : " + date2);

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

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

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

Résultat typique

DateHeure actuelle : 2014-12-09T11:00:45.457
date1 : 2014-12-09
Mois : DECEMBER jour : 9 secondes : 45
date2 : 2012-12-10T11:00:45.457
date3 : 2014-12-12
date4 : 22:15
date5 : 20:15:30

API Zoned Date-Time

Pour les calculs avec fuseaux horaires.

Exemple

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("Fuseau actuel : " + currentZone);
    }
}

Résultat

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

Enum ChronoUnit

java.time.temporal.ChronoUnit remplace les entiers de l'ancienne API pour représenter jours, mois, etc.

Exemple

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("Date actuelle : " + today);

        LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
        System.out.println("Semaine prochaine : " + nextWeek);

        LocalDate nextMonth = today.plus(1, ChronoUnit.MONTHS);
        System.out.println("Mois prochain : " + nextMonth);

        LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
        System.out.println("Année prochaine : " + nextYear);

        LocalDate nextDecade = today.plus(1, ChronoUnit.DECADES);
        System.out.println("Dans dix ans : " + nextDecade);
    }
}

Résultat

Date actuelle : 2014-12-10
Semaine prochaine : 2014-12-17
Mois prochain : 2015-01-10
Année prochaine : 2015-12-10
Dans dix ans : 2024-12-10

Period et Duration

Deux classes spécialisées pour les différences temporelles :

• Period : Quantité de temps basée sur la date (années, mois, jours).

• Duration : Quantité de temps basée sur l'heure (heures, minutes, secondes).

Exemple

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("Date actuelle : " + date1);

        LocalDate date2 = date1.plus(1, ChronoUnit.MONTHS);
        System.out.println("Mois prochain : " + date2);

        Period period = Period.between(date2, date1);
        System.out.println("Période : " + 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("Durée : " + duration);
    }
}

Résultat

Date actuelle : 2014-12-10
Mois prochain : 2015-01-10
Période : P-1M
Durée : PT2H

Temporal Adjusters

TemporalAdjuster permet les calculs de dates complexes : « deuxième samedi du mois », « prochain mardi », etc.

Exemple

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("Date actuelle : " + date1);

        LocalDate nextTuesday = date1.with(TemporalAdjusters.next(DayOfWeek.TUESDAY));
        System.out.println("Prochain mardi : " + nextTuesday);

        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("Deuxième samedi : " + secondSaturday);
    }
}

Résultat

Date actuelle : 2014-12-10
Prochain mardi : 2014-12-16
Deuxième samedi : 2014-12-13

Compatibilité ascendante

La méthode toInstant() ajoutée à Date et Calendar permet la conversion vers la nouvelle API. Utilisez ofInstant(Instant, ZoneId) pour obtenir un LocalDateTime ou ZonedDateTime.

Exemple

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("Date actuelle : " + currentDate);

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

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

        ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(now, currentZone);
        System.out.println("Date zonnée : " + zonedDateTime);
    }
}

Résultat

Date actuelle : Wed Dec 10 05:44:06 UTC 2014
Date locale : 2014-12-10T05:44:06.635
Date zonnée : 2014-12-10T05:44:06.635Z[Etc/UTC]