目录

  • 1 新时间日期优点
  • 2 主要类
  • 3 常用方法
  • 3.1 LocalDateTime、LocalDate、LocalTime
  • 3.2 Instant时间戳
  • 3.3 Duration、Period时间间隔
  • 3.4 TemporalAdjuster时间校正器
  • 3.5 DateTimeFormatter解析和格式化
  • 3.6 ZoneDate、ZoneTime、ZoneDateTime


1 新时间日期优点

  1. 不变性：新的日期/时间API中，所有的类都是不可变的，线程安全点，这对多线程环境有好处。
  2. 关注点分离：新的API将人可读的日期时间和机器时间（unix timestamp）明确分离，它为日期（Date）、时间（Time）、日期时间（DateTime）、时间戳（unix timestamp）以及时区定义了不同的类。
  3. 清晰：在所有的类中，方法都被明确定义用以完成相同的行为。举个例子，要拿到当前实例我们可以使用now()方法，在所有的类中都定义了format()和parse()方法，而不是像以前那样专门有一个独立的类。为了更好的处理问题，所有的类都使用了工厂模式和策略模式，一旦你使用了其中某个类的方法，与其他类协同工作并不困难。
  4. 实用操作：所有新的日期/时间API类都实现了一系列方法用以完成通用的任务，如：加、减、- - 格式化、解析、从日期/时间中提取单独部分，等等。
  5. 可扩展性：新的日期/时间API是工作在ISO-8601日历系统上的，但我们也可以将其应用在非IOS的日历上。

2 主要类

  1. Instant：它代表的是时间戳
  2. LocalDate：不包含具体时间的日期
  3. LocalTime：它代表的是不含日期的时间
  4. LocalDateTime：它包含了日期及时间，不过还是没有偏移信息或者说时区
  5. ZonedDateTime：这是一个包含时区的完整的日期时间，偏移量是以UTC/格林威治时间为基准的

3 常用方法

3.1 LocalDateTime、LocalDate、LocalTime

这三个类的操作方法都类似，这里以LocalDateTime为例

  1. 获取LocalDateTime实例
LocalDateTime ldt1 = LocalDateTime.now();//当前时间
LocalDateTime ldt2 = LocalDateTime.of(2018, 12, 25, 12, 59, 30);//指定时间
  1. 获取年月日时分秒
int year = ldt1.getYear();
int month = ldt1.getMonthValue();
int day = ldt1.getDayOfMonth();
int hour = ldt1.getHour();
int minute = ldt1.getMinute();
int second = ldt1.getSecond();
  1. 运算，返回一个新的LocalDateTime
ldt1.plusYears(1);
ldt1.plusMonths(1);
ldt1.plusDays(1);
ldt1.plusHours(1);
ldt1.plusMinutes(1);
ldt1.plusSeconds(1);

3.2 Instant时间戳

时间戳，从1970年1月1日00:00:00开始的毫秒数

  1. 获取Instant实例
Instant ins1 = Instant.now();
  1. 获取时间戳
ins1.toEpochMilli()//获取时间戳

3.3 Duration、Period时间间隔

  1. Duration : 用于计算两个“时间”间隔
Duration duration = Duration.between(ins1, ins2);
System.out.println(duration.getSeconds());//获取间隔毫秒数
System.out.println(duration.toMillis());//获取间隔秒数
  1. Period : 用于计算两个“日期”间隔
Period period = Period.between(ldt2, ldt1);
System.out.println(period.getYears());//获取间隔年数
System.out.println(period.getMonths());//获取间隔月数
System.out.println(period.getDays());//获取间隔天数

3.4 TemporalAdjuster时间校正器

有时我们可能需要获取例如:将日期调整到“下个周日”等操作。

  1. TemporalAdjusters类中提供了常用的的校正器
LocalDateTime ldt = LocalDateTime.now();
LocalDateTime ldt2 = ldt.with(TemporalAdjusters.next(DayOfWeek.SUNDAY));
System.out.println(ldt2);
  1. 自定义校正器：下一个工作日
LocalDateTime ldt3 = ldt.with((l) -> {
	LocalDateTime ldt4 = (LocalDateTime) l;
	DayOfWeek dow = ldt4.getDayOfWeek();
	if(dow.equals(DayOfWeek.FRIDAY)){
    	return ldt4.plusDays(3);
    }else if(dow.equals(DayOfWeek.SATURDAY)){
		return ldt4.plusDays(2);
	}else{
		return ldt4.plusDays(1);
	    }
	});
System.out.println(ldt3);

3.5 DateTimeFormatter解析和格式化

  1. 格式化
//常用格式
DateTimeFormatter dtf1 = DateTimeFormatter.ISO_DATE;
LocalDateTime ldt = LocalDateTime.now();
String dateStr1 = ldt.format(dtf1);//2019-01-10
//自定义格式
DateTimeFormatter dtf2 = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss");
String dateStr2 = ldt.format(dtf2);//2019年01月10日 22:33:25
  1. 解析
LocalDateTime newDate = ldt.parse(dateStr2, dtf2);

3.6 ZoneDate、ZoneTime、ZoneDateTime

  1. 查看所有时区
Set<String> zones = ZoneId.getAvailableZoneIds();
zones.forEach(System.out::println);
  1. 获取某个时区时间
LocalDateTime ldt = LocalDateTime.now(ZoneId.of("Europe/Tallinn"));
  1. 获取实例
LocalDateTime ldt = LocalDateTime.now();
ZoneDateTime zdt = ldt.atZone(ZoneId.of("Asia/Shanghai"));
System.out.println(zdt);//输出"2019-01-10T23:05:33.437+08:00[Asia/Shanghai]"