Java 8 - Новое API даты и времени

Здравствуйте, будущие маги Java! ? Сегодня мы отправимся в увлекательное путешествие по魔法льному миру API даты и времени Java. Не волнуйтесь, если вы еще ни разу не писали строку кода - мы начнем с самого начала и будем идти вместе. К концу этого урока вы будете управляться с датами и временем, как профи! Так что, погружаемся!

Java - Datetime Api

Введение в API даты и времени Java

Представьте, что вы строите машину времени (классно, правда?). Чтобы она работала, вам нужно обрабатывать даты и время с точностью. Именно для этого в наших программах существует API даты и времени Java. Это как иметь под рукой超级точные часы и календарь в одном!

Почему новое API?

Before мы перейдем к деталям, вы можете задаться вопросом: "Почему Java создала новое API даты и времени?" Давайте расскажу вам небольшую историю.

Once upon a time (до Java 8), разработчики использовали старые классы java.util.Date и java.util.Calendar. Это было как использование старого, ржавого clocks - они работали, но у них было множество проблем. Они были сложными в использовании, не обеспечивали thread-safe (что могло вызвать проблемы в сложных программах) и плохо обрабатывали часовые пояса.

Так что команда Java решила создать全新的, сверкающий API, который решит все эти проблемы. И вот так родился пакет java.time в Java 8!

API локальной даты и времени Java

Давайте начнем с азов. API локальной даты и времени позволяет нам работать с датами и временем, не задумываясь о часовых поясах. Это как иметь простой clock и календарь на вашем столе.

LocalDate

LocalDate представляет дату без времени и часового пояса. Давайте посмотрим, как его использовать:

import java.time.LocalDate;

public class DateExample {
public static void main(String[] args) {
LocalDate today = LocalDate.now();
System.out.println("Сегодняшняя дата: " + today);

LocalDate specificDate = LocalDate.of(2023, 6, 15);
System.out.println("Конкретная дата: " + specificDate);
}
}

В этом примере мы делаем две вещи:

  1. Получаем сегодняшнюю дату с помощью LocalDate.now().
  2. Создаем конкретную дату (15 июня 2023 года) с помощью LocalDate.of().

Когда вы запустите этот код, вы увидите сегодняшнюю дату и созданную нами конкретную дату.

LocalTime

LocalTime представляет время без даты и часового пояса. Вот как мы можем использовать его:

import java.time.LocalTime;

public class TimeExample {
public static void main(String[] args) {
LocalTime now = LocalTime.now();
System.out.println("Текущее время: " + now);

LocalTime specificTime = LocalTime.of(14, 30, 45);
System.out.println("Конкретное время: " + specificTime);
}
}

В этом примере:

  1. Получаем текущее время с помощью LocalTime.now().
  2. Создаем конкретное время (2:30:45 PM) с помощью LocalTime.of().

LocalDateTime

LocalDateTime combines both date and time, but still without a time zone. It's like having a clock that also shows the date. Here's how to use it:

import java.time.LocalDateTime;

public class DateTimeExample {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
System.out.println("Текущая дата и время: " + now);

LocalDateTime specificDateTime = LocalDateTime.of(2023, 6, 15, 14, 30, 45);
System.out.println("Конкретная дата и время: " + specificDateTime);
}
}

In this example:

  1. We're getting the current date and time using LocalDateTime.now().
  2. We're creating a specific date and time (June 15, 2023, at 2:30:45 PM) using LocalDateTime.of().

API дат и времени с часовыми поясами Java

Теперь добавим немного остроты в нашу машину времени - часовые пояса! API с часовыми поясами помогает нам работать с датами и временем, учитывая различные часовые пояса.

ZonedDateTime

ZonedDateTime represents a date-time with a time zone. It's like having a world clock that shows different times for different parts of the world.

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

public class ZonedDateTimeExample {
public static void main(String[] args) {
ZonedDateTime nowInSystemTZ = ZonedDateTime.now();
System.out.println("Текущая дата-время в системном часовом поясе: " + nowInSystemTZ);

ZonedDateTime nowInParis = ZonedDateTime.now(ZoneId.of("Europe/Paris"));
System.out.println("Текущая дата-время в Париже: " + nowInParis);
}
}

In this example:

  1. We're getting the current date-time in the system's default time zone using ZonedDateTime.now().
  2. We're getting the current date-time in Paris using ZonedDateTime.now(ZoneId.of("Europe/Paris")).

Enum ChronoUnits

The ChronoUnit enum provides a set of standard date periods and time units. It's like having different measuring tools for time - seconds, minutes, hours, days, weeks, months, years, and so on.

import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;

public class ChronoUnitExample {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
LocalDateTime futureDateTime = now.plus(1, ChronoUnit.WEEKS);

long daysBetween = ChronoUnit.DAYS.between(now, futureDateTime);
System.out.println("Дней между сегодня и через неделю: " + daysBetween);
}
}

In this example:

  1. We're adding one week to the current date-time using plus(1, ChronoUnit.WEEKS).
  2. We're calculating the number of days between now and one week from now using ChronoUnit.DAYS.between().

Period and Duration

Period and Duration are used to represent amounts of time. Think of Period as the difference between two dates on a calendar, and Duration as the time shown on a stopwatch.

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

public class PeriodDurationExample {
public static void main(String[] args) {
LocalDate date1 = LocalDate.of(2023, 1, 1);
LocalDate date2 = LocalDate.of(2023, 12, 31);
Period period = Period.between(date1, date2);
System.out.println("Период между " + date1 + " и " + date2 + ": " + period);

LocalTime time1 = LocalTime.of(9, 0);
LocalTime time2 = LocalTime.of(17, 30);
Duration duration = Duration.between(time1, time2);
System.out.println("Продолжительность между " + time1 + " и " + time2 + ": " + duration);
}
}

In this example:

  1. We're calculating the period between two dates using Period.between().
  2. We're calculating the duration between two times using Duration.between().

Temporal Adjusters

Temporal Adjusters are like magic wands for dates. They let you adjust dates in useful ways, like finding the next Monday or the last day of the month.

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

public class TemporalAdjustersExample {
public static void main(String[] args) {
LocalDate date = LocalDate.now();
LocalDate nextMonday = date.with(TemporalAdjusters.next(DayOfWeek.MONDAY));
System.out.println("Следующее понедельник: " + nextMonday);

LocalDate lastDayOfMonth = date.with(TemporalAdjusters.lastDayOfMonth());
System.out.println("Последний день этого месяца: " + lastDayOfMonth);
}
}

In this example:

  1. We're finding the date of the next Monday using TemporalAdjusters.next(DayOfWeek.MONDAY).
  2. We're finding the last day of the current month using TemporalAdjusters.lastDayOfMonth().

Backward Compatibility

Now, you might be wondering, "What about all the old code that uses the old date and time classes?" Don't worry! Java has thought of that too. The new API provides methods to convert between the old and new date-time classes.

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

public class BackwardCompatibilityExample {
public static void main(String[] args) {
// Converting old Date to new LocalDateTime
Date oldDate = new Date();
LocalDateTime newDateTime = LocalDateTime.ofInstant(oldDate.toInstant(), ZoneId.systemDefault());
System.out.println("Старая дата: " + oldDate);
System.out.println("Новый LocalDateTime: " + newDateTime);

// Converting new LocalDateTime to old Date
LocalDateTime localDateTime = LocalDateTime.now();
Date date = Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());
System.out.println("Новый LocalDateTime: " + localDateTime);
System.out.println("Старая дата: " + date);
}
}

In this example:

  1. We're converting an old Date object to a new LocalDateTime object.
  2. We're converting a new LocalDateTime object back to an old Date object.

This backward compatibility ensures that you can still work with older Java code while enjoying the benefits of the new Date-Time API.

Conclusion

Congratulations! You've just taken your first steps into the world of Java's Date-Time API. We've covered a lot of ground, from basic date and time handling to more advanced concepts like time zones and temporal adjusters.

Remember, like any skill, mastering date and time in Java takes practice. Don't be discouraged if it feels overwhelming at first - even experienced developers sometimes need to look up how to use these classes!

Keep experimenting with these examples, try modifying them, and see what happens. Before you know it, you'll be manipulating dates and times like a true Java time traveler!

Happy coding, and may your timing always be perfect! ⏰?

Credits: Image by storyset