Java 8 新特性：日期处理

1.  Java 8 日期处理新特性

　　Java 8基于ISO标准日期系统，提供了java.time包来处理时间日期，且该包下的所有类都是不可变类型而且线程安全。

2.  关键类

• Instant：瞬时实例。
• LocalDate：本地日期，不包含具体时间 例如：2014-01-14 可以用来记录生日、纪念日、加盟日等。
• LocalTime：本地时间，不包含日期。
• LocalDateTime：组合了日期和时间，但不包含时差和时区信息。
• ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。

　　新API还引入了 ZoneOffSet 和 ZoneId 类，解决时区问题。

　　对用于解析和格式化时间的 DateTimeFormatter 类也进行了优化。

3.  示例代码

import java.time.Clock;
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;
import java.time.MonthDay;
import java.time.OffsetDateTime;
import java.time.Period;
import java.time.Year;
import java.time.YearMonth;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoUnit;
import java.util.Date;

import org.junit.Test;

/**
 * Java 8 日期时间单元测试
 * 
 * @author CL
 *
 */
public class TestDateTime {

    /**
     * 测试当前时间
     */
    @Test
    public void testCurrentDate() {
        LocalDate localDate = LocalDate.now();
        System.out.printf("当前时间（不包含时间）： %s 
", localDate);

        Date date = new Date();
        System.out.printf("当前时间（包含时间）： %s 
", date);
    }

    /**
     * 测试详细日期，获取年、月、日
     */
    @Test
    public void testDetailsDate() {
        LocalDate today = LocalDate.now();
        int year = today.getYear();
        int month = today.getMonthValue();
        int day = today.getDayOfMonth();
        System.out.printf("今天是：%s 年 %s 月 %s 日", year, month, day);
    }

    /**
     * 测试特殊日期
     */
    @Test
    public void testSpecialDate() {
        LocalDate specialDate = LocalDate.of(2018, 5, 12);
        System.out.printf("%s 是个特殊的日子!", specialDate);
    }

    /**
     * 测试周期日期
     */
    @Test
    public void testCalculationDate() {
        LocalDate today = LocalDate.now();
        LocalDate laborDay = LocalDate.of(2020, 5, 1);

        MonthDay currMonthDay = MonthDay.from(today);
        MonthDay laborMonthDay = MonthDay.of(laborDay.getMonthValue(), laborDay.getDayOfMonth());

        if (currMonthDay.equals(laborMonthDay)) {
            System.out.println("今天是劳动节！");
        } else {
            System.out.println("今天不是劳动节！");
        }
    }

    /**
     * 测试当前时间
     */
    @Test
    public void testCurrentTime() {
        LocalTime localTime = LocalTime.now();
        System.out.printf("当前时间是：%s", localTime);
    }

    /**
     * 测试当前日期时间
     */
    @Test
    public void testCurrentDateTime() {
        LocalDateTime localDateTime = LocalDateTime.now();
        System.out.printf("当前日期时间是：%s", localDateTime);
    }

    /**
     * 测试加减日期时间
     */
    @Test
    public void testMinusPlusDateTime() {
        LocalDate localDate = LocalDate.now();
        LocalTime localTime = LocalTime.now();
        System.out.printf("两小时前的时间是：%s 
", localTime.minusHours(2L));
        System.out.printf("两小时后的时间是：%s 
", localTime.plusHours(2L));
        System.out.printf("一周前的日期是：%s 
", localDate.minus(1L, ChronoUnit.WEEKS));
        System.out.printf("一周后的日期是：%s 
", localDate.plus(1L, ChronoUnit.WEEKS));
        System.out.printf("一年前的日期是：%s 
", localDate.minus(1L, ChronoUnit.YEARS));
        System.out.printf("一年后的日期是：%s 
", localDate.plus(1L, ChronoUnit.YEARS));
    }

    /**
     * 测试时钟类
     */
    @Test
    public void testClock() {
        // 根据系统时间返回当前UTC
        Clock systemUTC = Clock.systemUTC();
        System.out.printf("当前UTC： %s 
", systemUTC);

        // 根据系统时区返回当前时区
        Clock systemDefaultZone = Clock.systemDefaultZone();
        System.out.printf("当前时区： %s 
", systemDefaultZone);
    }

    /**
     * 测试判断是否为前后日期
     */
    @Test
    public void testBeforeOrAfterDate() {
        LocalDate today = LocalDate.now();

        LocalDate yesterday = today.minus(1L, ChronoUnit.DAYS);
        if (yesterday.isBefore(today)) {
            System.out.printf("%s 是今天之前的日期！ 
", yesterday);
        }

        LocalDate tomorrow = today.plus(1L, ChronoUnit.DAYS);
        if (tomorrow.isAfter(today)) {
            System.out.printf("%s 是今天之后的日期！ 
", tomorrow);
        }
    }

    /**
     * 测试指定时区日期时间
     */
    @Test
    public void testZoneTime() {
        LocalDateTime localDateTime = LocalDateTime.now();

        ZoneId america = ZoneId.of("America/New_York");
        ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, america);
        System.out.printf("当前日期时间在指定时区的日期时间为： %s", zonedDateTime);
    }

    /**
     * 测试具体时区时间
     */
    @Test
    public void testZoneOffset() {
        LocalDateTime localDateTime = LocalDateTime.of(Year.now().getValue(), Month.FEBRUARY, 1, 12, 30);
        ZoneOffset zoneOffset = ZoneOffset.of("+08:00");

        OffsetDateTime offsetDateTime = OffsetDateTime.of(localDateTime, zoneOffset);
        System.out.printf("与当前时区指定时间相差8小时的时区时间为：%s", offsetDateTime);
    }

    /**
     * 测试天数
     */
    @Test
    public void testLengDays() {
        YearMonth yearMonth = YearMonth.now();
        System.out.printf("今天是 %s 年 %s 月，本年共有 %s 天，本月共有 %s 天", yearMonth.getYear(), yearMonth.getMonthValue(),
                yearMonth.lengthOfYear(), yearMonth.lengthOfMonth());
    }

    /**
     * 测试闰年
     */
    @Test
    public void testLeapYear() {
        LocalDate today = LocalDate.now();
        if (today.isLeapYear()) {
            System.out.printf("%s 年是闰年！", today.getYear());
        } else {
            System.out.printf("%s 年不是闰年！", today.getYear());
        }
    }

    /**
     * 测试计算时间间隔天数
     */
    @Test
    public void testCalcDays() {
        LocalDate today = LocalDate.now();
        LocalDate nextWeek = today.plus(1L, ChronoUnit.WEEKS);
        LocalDate nextMonth = today.plus(1L, ChronoUnit.MONTHS);
        LocalDate nextYear = today.plus(1L, ChronoUnit.YEARS);
        LocalDate anyDate = LocalDate.of(2022, 8, 8);

        Period periodOfNextWeek = Period.between(today, nextWeek);
        System.out.printf("%s 和 %s 之间距离 %s 年 %s 月  %s 天 
", today, nextWeek, periodOfNextWeek.getYears(),
                periodOfNextWeek.getMonths(), periodOfNextWeek.getDays());

        Period periodOfNextMonth = Period.between(today, nextMonth);
        System.out.printf("%s 和 %s 之间距离 %s 年 %s 月  %s 天 
", today, nextWeek, periodOfNextMonth.getYears(),
                periodOfNextMonth.getMonths(), periodOfNextMonth.getDays());

        Period periodOfNextYear = Period.between(today, nextYear);
        System.out.printf("%s 和 %s 之间距离 %s 年 %s 月  %s 天 
", today, nextWeek, periodOfNextYear.getYears(),
                periodOfNextYear.getMonths(), periodOfNextYear.getDays());

        Period periodOfAnyDate = Period.between(today, anyDate);
        System.out.printf("%s 和 %s 之间距离 %s 年 %s 月  %s 天 
", today, anyDate, periodOfAnyDate.getYears(),
                periodOfAnyDate.getMonths(), periodOfAnyDate.getDays());
    }

    /**
     * 测试当前时间戳
     */
    @Test
    public void testTimestamp() {
        Instant timestamp = Instant.now();
        System.out.printf("当前时间戳是：%s", timestamp);
    }

    /**
     * 测试格式化日期时间
     */
    @Test
    public void testFormatDateTime() {
        String date = "20080808";
        LocalDate localDate = LocalDate.parse(date, DateTimeFormatter.BASIC_ISO_DATE);
        System.out.printf("%s 格式化后为： %s 
", date, localDate);

        String dateTime = "2020-01-01T12:30";
        LocalDateTime localDateTime = LocalDateTime.parse(dateTime, DateTimeFormatter.BASIC_ISO_DATE);
        System.out.printf("%s 格式化后为： %s 
", dateTime, localDateTime);
    }
}