本地日期类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秒