Java开发笔记（四十三）更好用的本地日期时间

话说Java一连设计了两套时间工具，分别是日期类型Date，以及日历类型Calendar，按理说用在编码开发中绰绰有余了。然而随着Java的日益广泛使用，人们还是发现了它们的种种弊端。且不说先天不良的Date类型，单说后起之秀的Calendar类型，这个日历工具在实际开发中仍然存在以下毛病：
1、日历工具获取当前月份的时候，与Date一样都是从0开始计数，比如通过get方法获得的一月份数值为0；
2、日历工具获取当天是星期几的时候，星期日是排在最前面的，通过get方法获得的星期日数值为1，而星期一数值居然是2！
3、日历工具能够表达的最小时间单位是毫秒，使得时间精度不够高，难以用在更加精密的科学运算场合。
4、日历工具没有提供闰年的判断方法。
5、日历工具缺乏自己的格式化工具，居然还得借助于Date类型那边的格式化工具SimpleDateFormat，方能将日期时间按照指定格式输出为字符串。
总而言之，不管是Date还是Calendar，在解决复杂问题之时的编码都很别扭，故而每个Java工程基本要重新编写一个日期处理工具DateUtil，在新工具内部封装常见的日期处理操作，这样才能满足实际业务的开发要求。于是Date和Calendar两个难兄难弟从JDK1.1开始并肩作战，一路走到Java5、Java6乃至Java7，后来估摸着无可救药了，干爹Oracle一不做、二不休，终于在Java8推出了全新的日期时间类型，意图通过新类型一劳永逸治好Date和Calendar的沉疴宿疾。
全新的日期时间类型不单单是一个类型，而是一个家族，它的成员主要有LocalDate、LocalTime、LocalDateTime等等，接下来分别介绍这几个日期时间类型：

1、本地日期类型LocalDate
获取本地日期的实例很简单，调用该类型的now方法即可，并且顾名思义得到的是当前日期。通过本地日期获取年月日的数值，就是日常生活中的习惯数字，例如一月份对应的数值是1，十二月份对应的数值是12，星期一对应的数值是1，星期日对应的数值是7等等。此外，本地日期额外提供了几个常用的统计方法，包括：该日期所在的年份一共有多少天、该日期所在的月份一共有多少天、该日期所在的年份是否为闰年等。下面的代码便演示了如何从本地日期获取各种数值的例子：

		// 获得本地日期的实例
		LocalDate date = LocalDate.now();
		System.out.println("date=" + date.toString());
		// 获得该日期所在的年份
		int year = date.getYear();
		System.out.println("year=" + year);
		// 获得该日期所在的月份。注意getMonthValue方法返回的是数字月份，而getMonth方法返回的是英文月份
		int month = date.getMonthValue();
		System.out.println("month=" + month + ", english month=" + date.getMonth());
		// 获得该日期所在的日子
		int dayOfMonth = date.getDayOfMonth();
		System.out.println("dayOfMonth=" + dayOfMonth);
		// 获得该日期在一年当中的序号
		int dayOfYear = date.getDayOfYear();
		System.out.println("dayOfYear=" + dayOfYear);
		// 获得该日期是星期几。注意getDayOfWeek方法返回的是英文的星期几，后面跟着的getValue方法才返回数字的星期几
		int dayOfWeek = date.getDayOfWeek().getValue();
		System.out.println("dayOfWeek=" + dayOfWeek + ", english weekday=" + date.getDayOfWeek());
		// 获得该日期所在的年份一共有多少天
		int lengthOfYear = date.lengthOfYear();
		System.out.println("lengthOfYear=" + lengthOfYear);
		// 获得该日期所在的月份一共有多少天
		int lengthOfMonth = date.lengthOfMonth();
		System.out.println("lengthOfMonth=" + lengthOfMonth);
		// 判断该日期所在的年份是否为闰年
		boolean isLeapYear = date.isLeapYear();
		System.out.println("isLeapYear=" + isLeapYear);

除了创建处于当前日期的本地实例，LocalDate还支持创建指定日期的本地实例，就像以下代码示范的那样：

		// 构造一个指定年月日的日期实例
		LocalDate dateManual = LocalDate.of(2018, 11, 22);
		System.out.println("dateManual=" + dateManual.toString());

至于针对某个单位的数值，LocalDate也提供了专门的修改方法，例如以plus打头的系列方法用来增加日期数值，以minus打头的系列方法用来减少日期数值，以with打头的系列方法用来设置日期数值，这些日期修改的具体用法示例如下：

		dateManual = dateManual.plusYears(0); // 增加若干年份
		dateManual = dateManual.plusMonths(0); // 增加若干月份
		dateManual = dateManual.plusDays(0); // 增加若干日子
		dateManual = dateManual.plusWeeks(0); // 增加若干星期
		dateManual = dateManual.minusYears(0); // 减少若干年份
		dateManual = dateManual.minusMonths(0); // 减少若干月份
		dateManual = dateManual.minusDays(0); // 减少若干日子
		dateManual = dateManual.minusWeeks(0); // 减少若干星期
		dateManual = dateManual.withYear(2000); // 设置指定的年份
		dateManual = dateManual.withMonth(12); // 设置指定的月份
		dateManual = dateManual.withDayOfYear(1); // 设置当年的日子
		dateManual = dateManual.withDayOfMonth(1); // 设置当月的日子

此外，作为一种日期类型，LocalDate一如既往地支持判断两个日期实例的早晚关系，比如equals方法用于判断两个日期是否相等，isBefore方法用于判断A日期是否在B日期之前，isAfter方法用于判断A日期是否在B日期之后等。具体的本地日期校验代码如下所示：

		// 判断两个日期是否相等
		boolean equalsDate = date.equals(dateManual);
		System.out.println("equalsDate=" + equalsDate);
		// 判断A日期是否在B日期之前
		boolean isBeforeDate = date.isBefore(dateManual);
		System.out.println("isBeforeDate=" + isBeforeDate);
		// 判断A日期是否在B日期之后
		boolean isAfterDate = date.isAfter(dateManual);
		System.out.println("isAfterDate=" + isAfterDate);
		// 判断A日期是否与B日期相等
		boolean isEqualDate = date.isEqual(dateManual);
		System.out.println("isEqualDate=" + isEqualDate);

　　

2、本地时间类型LocalTime
前面介绍的LocalDate只能操作年月日，若要操作时分秒则需通过本地时间类型LocalTime。获取本地时间的实例依然要调用该类型的now方法，接着就能通过该实例分别获取对应的时分秒乃至纳秒（一秒的十亿分之一），下面便演示了如何调用LocalTime的基本方法：

		// 获得本地时间的实例
		LocalTime time = LocalTime.now();
		System.out.println("time=" + time.toString());
		// 获得该时间所在的时钟
		int hour = time.getHour();
		System.out.println("hour=" + hour);
		// 获得该时间所在的分钟
		int minute = time.getMinute();
		System.out.println("minute=" + minute);
		// 获得该时间所在的秒钟
		int second = time.getSecond();
		System.out.println("second=" + second);
		// 获得该时间秒钟后面的纳秒单位。一秒等于一千毫秒，一毫秒等于一千微秒，一微秒等于一千纳秒，算下来一秒等于十亿纳秒
		int nano = time.getNano();
		System.out.println("nano=" + nano);

如同本地日期LocalDate那样，LocalTime也允许创建指定时分秒的时间实例，还支持单独修改时钟、分钟、秒钟和纳秒。当然修改时间的途径包括plus系列方法、minus系列方法、with系列方法等等，它们的调用方式示例如下：

		// 构造一个指定时分秒的时间实例
		LocalTime timeManual = LocalTime.of(14, 30, 25);
		System.out.println("timeManual=" + timeManual.toString());
		timeManual = timeManual.plusHours(0); // 增加若干时钟
		timeManual = timeManual.plusMinutes(0); // 增加若干分钟
		timeManual = timeManual.plusSeconds(0); // 增加若干秒钟
		timeManual = timeManual.plusNanos(0); // 增加若干纳秒
		timeManual = timeManual.minusHours(0); // 减少若干时钟
		timeManual = timeManual.minusMinutes(0); // 减少若干分钟
		timeManual = timeManual.minusSeconds(0); // 减少若干秒钟
		timeManual = timeManual.minusNanos(0); // 减少若干纳秒
		timeManual = timeManual.withHour(0); // 设置指定的时钟
		timeManual = timeManual.withMinute(0); // 设置指定的分钟
		timeManual = timeManual.withSecond(0); // 设置指定的秒钟
		timeManual = timeManual.withNano(0); // 设置指定的纳秒

另外，LocalTime依然提供了equals、isBefore、isAfter等方法用于判断两个时间的先后关系，具体的方法调用如下所示：

		// 判断两个时间是否相等
		boolean equalsTime = time.equals(timeManual);
		System.out.println("equalsTime=" + equalsTime);
		// 判断A时间是否在B时间之前
		boolean isBeforeTime = time.isBefore(timeManual);
		System.out.println("isBeforeTime=" + isBeforeTime);
		// 判断A时间是否在B时间之后
		boolean isAfterTime = time.isAfter(timeManual);
		System.out.println("isAfterTime=" + isAfterTime);

　　

3、本地日期时间类型LocalDateTime
现在有了LocalDate专门处理年月日，又有了LocalTime专门处理时分秒，还需要一种类型能够同时处理年月日和时分秒，它就是本地日期时间类型LocalDateTime。LocalDateTime基本等价于LocalDateTime与LocalTime的合集，它同时拥有二者的绝大部分方法，故这里不再赘述。下面是创建该类型实例的代码片段，读者可参考之前LocalDateTime与LocalTime的调用代码，尝试补齐LocalDateTime的方法调用过程。

	// 演示LocalDateTime的各种方法
	private static void showLocalDateTime() {
		// 获得本地日期时间的实例
		LocalDateTime datetime = LocalDateTime.now();
		System.out.println("datetime=" + datetime.toString());
		// LocalDateTime的方法是LocalDate与LocalTime的合集，
		// 也就是说LocalDate与LocalTime的大部分方法可以直接拿来给LocalDateTime使用，
		// 因而下面不再演示LocalDateTime的详细方法如何调用了。
		// 注意LocalDateTime不提供lengthOfYear、lengthOfMonth、isLeapYear这三个方法。
	}

　　

更多Java技术文章参见《Java开发笔记（序）章节目录》