Java 8: Новый надежный Date/Time API — Полное руководство

В Java 8 представлен новый API даты и времени (java.time), устраняющий недостатки старого API (java.util.Date, Calendar):

• Не потокобезопасность — java.util.Date изменяем и небезопасен в многопоточной среде. Новый API неизменяем и не имеет сеттеров.

• Плохой дизайн — в старом API год начинается с 1900, месяцы с 1, дни с 0. Нет единообразия и удобных методов. Новый API предоставляет множество утилит.

• Сложная работа с часовыми поясами — требовала много кода. Новый API спроектирован с учетом доменной специфики.

Основные пакеты: java.time, java.time.temporal, java.time.zone.

Ключевые классы:

• Local — упрощенный API без сложностей часовых поясов (LocalDate, LocalTime, LocalDateTime).

• Zoned — специализированный API для работы с часовыми поясами (ZonedDateTime, ZoneId).

Local Date-Time API

Классы LocalDate, LocalTime, LocalDateTime идеальны, когда часовые пояса не нужны.

Пример: 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("Current DateTime: " + 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("Month: " + month + " day: " + day + " seconds: " + seconds);

        // Манипуляции: 10-е число 2012 года
        LocalDateTime date2 = currentTime.withDayOfMonth(10).withYear(2012);
        System.out.println("date2: " + date2);

        // Создание даты: 12 декабря 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);

        // Парсинг строки
        LocalTime date5 = LocalTime.parse("20:15:30");
        System.out.println("date5: " + date5);
    }
}

Результат

Current DateTime: 2014-12-09T11:00:45.457
date1: 2014-12-09
Month: DECEMBER day: 9 seconds: 45
date2: 2012-12-10T11:00:45.457
date3: 2014-12-12
date4: 22:15
date5: 20:15:30

Zoned Date-Time API

Используется, когда важны часовые пояса.

Пример

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);
    }
}

Результат

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

Enum ChronoUnit

java.time.temporal.ChronoUnit заменяет целочисленные константы для представления единиц времени (день, месяц и т.д.).

Пример

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("Current date: " + today);

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

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

        LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
        System.out.println("Next year: " + nextYear);

        LocalDate nextDecade = today.plus(1, ChronoUnit.DECADES);
        System.out.println("Date after ten year: " + nextDecade);
    }
}

Результат

Current date: 2014-12-10
Next week: 2014-12-17
Next month: 2015-01-10
Next year: 2015-12-10
Date after ten year: 2024-12-10

Period и Duration

Два специализированных класса для работы с разницами во времени:

• Period — работает с датами (года, месяцы, дни).

• Duration — работает со временем (часы, минуты, секунды, наносекунды).

Пример

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("Current date: " + date1);

        LocalDate date2 = date1.plus(1, ChronoUnit.MONTHS);
        System.out.println("Next month: " + 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);
    }
}

Результат

Current date: 2014-12-10
Next month: 2015-01-10
Period: P-1M
Duration: PT2H

Temporal Adjusters (Корректировщики времени)

TemporalAdjuster используется для сложных вычислений дат: «вторник следующей недели», «вторая суббота месяца» и т.д.

Пример

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("Current date: " + date1);

        // Следующий вторник
        LocalDate nextTuesday = date1.with(TemporalAdjusters.next(DayOfWeek.TUESDAY));
        System.out.println("Next Tuesday on: " + nextTuesday);

        // Вторая суббота текущего месяца
        LocalDate firstInMonth = LocalDate.of(date1.getYear(), date1.getMonth(), 1);
        LocalDate secondSaturday = firstInMonth.with(TemporalAdjusters.nextOrSame(DayOfWeek.SATURDAY))
                                               .with(TemporalAdjusters.next(DayOfWeek.SATURDAY));
        System.out.println("Second Saturday on: " + secondSaturday);
    }
}

Результат

Current date: 2014-12-10
Next Tuesday on: 2014-12-16
Second Saturday on: 2014-12-13

Обратная совместимость

Метод toInstant() добавлен в Date и Calendar для конвертации в новый API. Используйте ofInstant(Instant, ZoneId) для получения LocalDateTime или ZonedDateTime.

Пример

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("Current date: " + currentDate);

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

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

        ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(now, currentZone);
        System.out.println("Zoned date: " + zonedDateTime);
    }
}

Результат

Current date: Wed Dec 10 05:44:06 UTC 2014
Local date: 2014-12-10T05:44:06.635
Zoned date: 2014-12-10T05:44:06.635Z[Etc/UTC]