[BAEL-8456] - Moved Java Date articles into a new module - 'java-dates'

java-dates/src/main/java/com/baeldung/datetime/AddHoursToDate.java

@@ -0,0 +1,54 @@
+package com.baeldung.datetime;
+
+import java.time.Duration;
+import java.time.Instant;
+import java.time.LocalDateTime;
+import java.time.ZonedDateTime;
+import java.time.temporal.ChronoUnit;
+import java.util.Calendar;
+import java.util.Date;
+
+import org.apache.commons.lang3.time.DateUtils;
+
+public class AddHoursToDate {
+
+    public Date addHoursToJavaUtilDate(Date date, int hours) {
+        Calendar calendar = Calendar.getInstance();
+        calendar.setTime(date);
+        calendar.add(Calendar.HOUR_OF_DAY, hours);
+        return calendar.getTime();
+    }
+
+    public Date addHoursToDateUsingInstant(Date date, int hours) {
+        return Date.from(date.toInstant()
+            .plus(Duration.ofHours(hours)));
+    }
+
+    public LocalDateTime addHoursToLocalDateTime(LocalDateTime localDateTime, int hours) {
+        return localDateTime.plusHours(hours);
+    }
+
+    public LocalDateTime subtractHoursToLocalDateTime(LocalDateTime localDateTime, int hours) {
+        return localDateTime.minusHours(hours);
+    }
+
+    public ZonedDateTime addHoursToZonedDateTime(ZonedDateTime zonedDateTime, int hours) {
+        return zonedDateTime.plusHours(hours);
+    }
+
+    public ZonedDateTime subtractHoursToZonedDateTime(ZonedDateTime zonedDateTime, int hours) {
+        return zonedDateTime.minusHours(hours);
+    }
+
+    public Instant addHoursToInstant(Instant instant, int hours) {
+        return instant.plus(hours, ChronoUnit.HOURS);
+    }
+
+    public Instant subtractHoursToInstant(Instant instant, int hours) {
+        return instant.minus(hours, ChronoUnit.HOURS);
+    }
+
+    public Date addHoursWithApacheCommons(Date date, int hours) {
+        return DateUtils.addHours(date, hours);
+    }
+}

java-dates/src/main/java/com/baeldung/datetime/README.md

@@ -0,0 +1,2 @@
+### Relevant Articles:
+- [Introduction to the Java 8 Date/Time API](http://www.baeldung.com/java-8-date-time-intro)

java-dates/src/main/java/com/baeldung/datetime/UseDuration.java

@@ -0,0 +1,15 @@
+package com.baeldung.datetime;
+
+import java.time.Duration;
+import java.time.LocalTime;
+
+public class UseDuration {
+
+    public LocalTime modifyDates(LocalTime localTime, Duration duration) {
+        return localTime.plus(duration);
+    }
+
+    public Duration getDifferenceBetweenDates(LocalTime localTime1, LocalTime localTime2) {
+        return Duration.between(localTime1, localTime2);
+    }
+}

java-dates/src/main/java/com/baeldung/datetime/UseLocalDate.java

@@ -0,0 +1,73 @@
+package com.baeldung.datetime;
+
+import java.time.DayOfWeek;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.temporal.ChronoUnit;
+import java.time.temporal.TemporalAdjusters;
+
+class UseLocalDate {
+
+    LocalDate getLocalDateUsingFactoryOfMethod(int year, int month, int dayOfMonth) {
+        return LocalDate.of(year, month, dayOfMonth);
+    }
+
+    LocalDate getLocalDateUsingParseMethod(String representation) {
+        return LocalDate.parse(representation);
+    }
+
+    LocalDate getLocalDateFromClock() {
+        LocalDate localDate = LocalDate.now();
+        return localDate;
+    }
+
+    LocalDate getNextDay(LocalDate localDate) {
+        return localDate.plusDays(1);
+    }
+
+    LocalDate getPreviousDay(LocalDate localDate) {
+        return localDate.minus(1, ChronoUnit.DAYS);
+    }
+
+    DayOfWeek getDayOfWeek(LocalDate localDate) {
+        DayOfWeek day = localDate.getDayOfWeek();
+        return day;
+    }
+
+    LocalDate getFirstDayOfMonth() {
+        LocalDate firstDayOfMonth = LocalDate.now().with(TemporalAdjusters.firstDayOfMonth());
+        return firstDayOfMonth;
+    }
+
+    LocalDateTime getStartOfDay(LocalDate localDate) {
+        LocalDateTime startofDay = localDate.atStartOfDay();
+        return startofDay;
+    }
+
+    LocalDateTime getStartOfDayOfLocalDate(LocalDate localDate) {
+        LocalDateTime startofDay = LocalDateTime.of(localDate, LocalTime.MIDNIGHT);
+        return startofDay;
+    }
+
+    LocalDateTime getStartOfDayAtMinTime(LocalDate localDate) {
+        LocalDateTime startofDay = localDate.atTime(LocalTime.MIN);
+        return startofDay;
+    }
+
+    LocalDateTime getStartOfDayAtMidnightTime(LocalDate localDate) {
+        LocalDateTime startofDay = localDate.atTime(LocalTime.MIDNIGHT);
+        return startofDay;
+    }
+
+    LocalDateTime getEndOfDay(LocalDate localDate) {
+        LocalDateTime endOfDay = localDate.atTime(LocalTime.MAX);
+        return endOfDay;
+    }
+
+    LocalDateTime getEndOfDayFromLocalTime(LocalDate localDate) {
+        LocalDateTime endOfDate = LocalTime.MAX.atDate(localDate);
+        return endOfDate;
+    }
+
+}

java-dates/src/main/java/com/baeldung/datetime/UseLocalDateTime.java

@@ -0,0 +1,24 @@
+package com.baeldung.datetime;
+
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.temporal.ChronoField;
+
+public class UseLocalDateTime {
+
+    public LocalDateTime getLocalDateTimeUsingParseMethod(String representation) {
+        return LocalDateTime.parse(representation);
+    }
+
+    LocalDateTime getEndOfDayFromLocalDateTimeDirectly(LocalDateTime localDateTime) {
+        LocalDateTime endOfDate = localDateTime.with(ChronoField.NANO_OF_DAY, LocalTime.MAX.toNanoOfDay());
+        return endOfDate;
+    }
+
+    LocalDateTime getEndOfDayFromLocalDateTime(LocalDateTime localDateTime) {
+        LocalDateTime endOfDate = localDateTime.toLocalDate()
+            .atTime(LocalTime.MAX);
+        return endOfDate;
+    }
+
+}

java-dates/src/main/java/com/baeldung/datetime/UseLocalTime.java

@@ -0,0 +1,31 @@
+package com.baeldung.datetime;
+
+import java.time.LocalTime;
+import java.time.temporal.ChronoUnit;
+
+public class UseLocalTime {
+
+    LocalTime getLocalTimeUsingFactoryOfMethod(int hour, int min, int seconds) {
+        return LocalTime.of(hour, min, seconds);
+    }
+
+    LocalTime getLocalTimeUsingParseMethod(String timeRepresentation) {
+        return LocalTime.parse(timeRepresentation);
+    }
+
+    private LocalTime getLocalTimeFromClock() {
+        return LocalTime.now();
+    }
+
+    LocalTime addAnHour(LocalTime localTime) {
+        return localTime.plus(1, ChronoUnit.HOURS);
+    }
+
+    int getHourFromLocalTime(LocalTime localTime) {
+        return localTime.getHour();
+    }
+
+    LocalTime getLocalTimeWithMinuteSetToValue(LocalTime localTime, int minute) {
+        return localTime.withMinute(minute);
+    }
+}

java-dates/src/main/java/com/baeldung/datetime/UsePeriod.java

@@ -0,0 +1,15 @@
+package com.baeldung.datetime;
+
+import java.time.LocalDate;
+import java.time.Period;
+
+class UsePeriod {
+
+    LocalDate modifyDates(LocalDate localDate, Period period) {
+        return localDate.plus(period);
+    }
+
+    Period getDifferenceBetweenDates(LocalDate localDate1, LocalDate localDate2) {
+        return Period.between(localDate1, localDate2);
+    }
+}

java-dates/src/main/java/com/baeldung/datetime/UseToInstant.java

@@ -0,0 +1,17 @@
+package com.baeldung.datetime;
+
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+import java.util.Calendar;
+import java.util.Date;
+
+public class UseToInstant {
+
+    public LocalDateTime convertDateToLocalDate(Date date) {
+        return LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());
+    }
+
+    public LocalDateTime convertDateToLocalDate(Calendar calendar) {
+        return LocalDateTime.ofInstant(calendar.toInstant(), ZoneId.systemDefault());
+    }
+}

java-dates/src/main/java/com/baeldung/datetime/UseZonedDateTime.java

@@ -0,0 +1,42 @@
+package com.baeldung.datetime;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+import java.time.temporal.ChronoField;
+
+class UseZonedDateTime {
+
+    ZonedDateTime getZonedDateTime(LocalDateTime localDateTime, ZoneId zoneId) {
+        return ZonedDateTime.of(localDateTime, zoneId);
+    }
+
+    ZonedDateTime getStartOfDay(LocalDate localDate, ZoneId zone) {
+        ZonedDateTime startofDay = localDate.atStartOfDay()
+            .atZone(zone);
+        return startofDay;
+    }
+
+    ZonedDateTime getStartOfDayShorthand(LocalDate localDate, ZoneId zone) {
+        ZonedDateTime startofDay = localDate.atStartOfDay(zone);
+        return startofDay;
+    }
+
+    ZonedDateTime getStartOfDayFromZonedDateTime(ZonedDateTime zonedDateTime) {
+        ZonedDateTime startofDay = zonedDateTime.toLocalDateTime()
+            .toLocalDate()
+            .atStartOfDay(zonedDateTime.getZone());
+        return startofDay;
+    }
+
+    ZonedDateTime getStartOfDayAtMinTime(ZonedDateTime zonedDateTime) {
+        ZonedDateTime startofDay = zonedDateTime.with(ChronoField.HOUR_OF_DAY, 0);
+        return startofDay;
+    }
+
+    ZonedDateTime getStartOfDayAtMidnightTime(ZonedDateTime zonedDateTime) {
+        ZonedDateTime startofDay = zonedDateTime.with(ChronoField.NANO_OF_DAY, 0);
+        return startofDay;
+    }
+}