Java-日期-时间API

本地日期类LocalDate

创建LocalDate对象的方法

public static LocalDate now():获得默认时区的系统时钟的当前日期

public static LocalDate of(int year,int month,int dayOfMonth):通过指定的年月日获得创建对象，月份的有效值为1-12，日的有效值为1-31，如果指定的值非法则抛出异常

日期-时间API中大多数类创建的对象都是不可变的，即对象一经创建就不能改变，这些对象也是线程安全的。创建日期-时间对象使用工厂方法而不是构造方法，如now()方法、of()方法、from()方法、with()方法等。这些类也没有修改方法。

常用方法

plusDays,plusWeeks,plusMonths,plusYears给当前的对象增加几天、几周、几个月或几年

minusDays,minusWeeks,minusMonths,minusYears

plus,minus:给当前的LocalDate对象增加或减少一个Duration或Period

withDayOfMonth,withDayofYear,withMonth,withYear:将月的第几天、年的第几天作为心LocalDate对象返回或将月份或年修改为指定值并返回一个新的LocalDate对象

getDayOfWeek/Month/Year:返回星期几/月份中的第几天/年份中的第几天

getMonth,getMonthValue:返回Month的枚举值或月份的数字值

getYear:返回年份值

until:得到两个日期之间的Period对象或指定ChronoUnits的数字

isBefore,isAfter:将当前LocalDate对象和另外LocalDate对象比较

isLeapYear:返回LocalDate对象是否闰年

lengthOfMonth,lengthOfYear:返回月的天数和年的天数

本地时间类

LocalTime对象表示本地时间，包含时、分、秒，它是不可变对象，最小精度是纳秒。时间对象中不包含日期和时区。

创建LocalTime对象的方法

public static LocalTime now()

public static LocalTime of(int hour,int munute,int second[,int nanoOfSecond])

常用方法

类似LocalDate类

LocalTime类的now()方法创建的对象默认带纳秒时间，也可以用truncatedTo()方法将其截短，不保留纳秒

LocalTime time = LocalTime.now();

LocatTime truncatedTime = time.truncatedTo(ChronoUnit.SECONDS);

本地日期时间类LocalDateTime

该类对象实际是LocalDate和LocalTime对象的组合，用来表示一个特定时间的事件

创建LocalTime对象的方法

public static LocalTime now()

public static LocalTime of(int year,int month,int dayOfMonth,int hour,int munute[,int second]):无设置秒则秒和纳秒设置为0

LocalDateTime类还定义了from()方法，可以从另一种时态格式转换成LocalDateTime实例

常用方法

类似LocalDate类

Instant类、Duration类、Period类

Instant类表示时间轴上的一个点，Duration类和Period类都表示一段时间，前者是基于时间的（秒、纳秒），后者是基于日期的（年、月、日）

Instant类

Instant.now()返回当前的瞬间时间点（格林尼治时间）

格式为年-月-日T时：分：秒.纳秒Z，如1970-01-01T00：00：00.00000Z

Duration类

Duration对象用来表示机器时间，他的测度是基于秒、纳秒的。如果创建Duration实例结束点在开始点之前，它的值可以为负值

为了计算两个瞬时点的时间差，可以使用静态方法Duration.between()

Instant start = Instant.now();
runAlgorithm();
Instant end = Instant.now();
Duration timeElapsed = Duration.between(start, end);
long millis = timeElapsed.toMillis();//得到算法执行的毫秒数

Period类

Period类表示基于日期（年、月、日）的一段时间，该类提供了getDays()、getMonths()、getYears()等方法从Period中抽取一段时间。整个时间段用年、月、日表示，如果要用单元一段时间单位表示，可以用ChronoUnit.between()方法

LocalDate today = LocalDate.now();
        LocalDate birthday = LocalDate.of(2002, 07, 06);
        Period p = Period.between(birthday, today);
        long p2 = ChronoUnit.DAYS.between(birthday, today);
        System.out.printf("%d岁%d月%d天,共%d天",p.getYears(),p.getMonths(),p.getDays(),p2);

其他常用类

Clock类、Year类、YearMonth类、MonthDay类、Month枚举以及ZonedDateTime与OffsetDateTime等

日期时间解析和格式化

日期-时间API提供了parse()方法解析包含日期和时间信息，还提供了format()方法格式化时态数据

时态数据解析

LocalDate.parse(CharSequence[,DateTimeFormatter])方法使用DateTimeFormatter格式化器解析CharSequence，默认的格式化器为ISO_LOCAL_DATE(用于解析形如“xxxx-xx-xx”的日期)若该字符串不能解析称对应的日期-时间数据则抛出异常,可以使用预定义的格式化器，如BASIC_ISO_DATE(用于解析型日xxxxxxxx的日期)也可以通过指定的模式定义格式化器

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy:MM:dd");
LocalDate date = LocalDate.parse("2020:10:10",formatter);
System.out.printf("%s%n",date);
//输出结果为：2020-10-10

LocalTime类同样有该方法

时态数据格式化

format(DateTimeFormatter)方法使用指定的格式将时态对象表示成字符串

 LocalDateTime date = LocalDateTime.now();
System.out.println(date);
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日ahh点mm分ss秒");
String text = date.format(formatter);
System.out.println(text);
//输出结果：2021-10-02T20:07:20.019260900
//        2021年10月02日下午08点07分20秒