Java8 中的时间和日期 API

1. 日期和时间概述

1. LocalDate

   ,

   LocalTime

   ,

   LocalDateTime

   类的实例是不可变的对象,分别表示使用 ISO-8601 日历系统
   的日期,时间,日期和时间;它们提供了简单的日期和时间,并不包含当前的时间信息;也不包含与时区相关的信息;

2. Instant

   : 时间戳(指定时间与 1970年1月1日 00:00:00 之间的毫秒值);

3. Duration

   : 计算两个"时间"之间的间隔;

4. Period

   : 计算两个"日期"之间的间隔;

// 测试类
public class TestLocalDateTime{

// 1. LocalDate, LocalTime, LocalDateTime
@Test
public void test(){
// 获取当前时间
LocalDateTime ldt = LocalDateTime.now();

System.out.println(ldt);

// 将当前时间中的日变成 10 日
LocalDateTime ldt5 = ldt.withDayOfMonth(10);
System.out.println(ldt5);

// 获取指定时间, 例如,指定 2017年10月2日,12时13分24秒
LocalDateTime ldt2 = LocalDateTime.of(2017,10,2,12,13,24);
System.out.println(ldt2);

// 时间的加减,都会产生一个新的实例
// 在当前时间的基础上,加两年
LocalDateTime ldt3 = ldt.plusYears(2); // 加两年
System.out.println(ldt3);

LocalDateTime ldt4 = ldt.minusMonths(2);
System.out.println(ldt4);

// 获取年(或月)
System.out.println(ldt.getYear());
System.out.println(ldt.getMonth());  // 返回 Month 对象
System.out.println(ldt.getMonthValue()); // 返回 int 类型

}

// 2. Instant
@Test
public void test2(){
Instant ins = Instant.now(); // 默认获取 UTC 时区
System.out.println(ins);

// 转换为中国时区,即带偏移量运算
OffsetDateTime odt = ins.atOffset(ZoneOffset.ofHours(8));
System.out.println(odt);

// 将ins转换成毫秒
System.out.println(ins.toEpochMilli());

// 将指定的毫秒转换为时间
Instant ins2 = Instant.ofEpochSecond(60);
System.out.println(ins2);
}

// 3. Duration / Period
@Test
public void test3(){
// 计算两个时间的间隔 Duration
Instant ins = Instant.now();

try{
Thread.sleep(1000);
}catch(InterruptedException e){

}

Instant ins2 = Instant.now();

Duration duration = Duration.between(ins,ins2);
System.out.println(duration.toMillis()); // 获取毫秒值
System.out.println(duration.getSeconds()); // 获取秒

// 计算两个日期的间隔 Period
LocalDate ld = LocalDate.of(2017,10,1);
LocalDate ld2 = LocalDate.now();

Period period = Period.between(ld, ld2);
System.out.println(period);
System.out.println(period.getYears());
}
}

2. 日期的操纵

• TemporalAdjuster 接口

  : 时间校正器;例如,将日期调整到"下个周日"的操作;

• TemporalAdjusters

  : 该类通过静态方法,提供了大量的常用

  TemporalAdjuster

  的实现;

// 测试类
public class TestDate{

// TemporalAdjuster
@Test
public void test(){
LocalDate ldt = LocalDate.now();

// 获取下个周日
LocalDate nextSunday = ldt.with(TemporalAdjusters.next(DayOfWeek.SUNDAY));
}
}

3. 日期格式化

// 测试类
public class TestDate{

// DateTimeFormatter: 格式化时间或日期
@Test
public void test(){
DateTimeFormatter dtf = DateTimeFormatter.ISO_DATE;
LocalDateTime ldt = LocalDateTime.now();

String str = ldt.format(dtf);
System.out.println(str);

// 自定义格式
DateTimeFormatter dtf2 = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss");
String str2 = dtf2.format(ldt);
System.out.println(str2);

// 将字符串转换成日期
LocalDateTime newDate = ldt.parse(str2,dtf2);
Sytem.out.println(newDate);
}
}

4. 时区的处理

• 带时区的时间分别为:

  ZonedDate

  ,

  ZonedTime

  ,

  ZonedDateTime

  ; 其中,每个时区都对应着ID; 地区ID都为
  "{区域}/{城市}"的格式,例如,"Asia/Shanghai";

• ZoneId

  : 该类中包含了所有的时区信息;

  getAvailableZoneIds()

  : 可以获取java8支持的所有时区;

• of(id)

  : 用指定的时区信息获取 ZoneId 对象;

//测试类
public class TestZone{
@Test
public void test(){

// 查看 java8 支持的所有时区
Set<String> set = ZoneId.getAvailableZoneIds();
set.forEach(System.out::println);

// 获取指定时区的当前时间
LocalDateTime ldt = LocalDateTime.now(ZoneId.of("Europe/London"));
System.out.println(ldt);

// 带时区的时间
ZonedDateTime zdt = ldt.atZone(ZoneId.of("Europe/London"));
System.out.println(zdt);
}
}

5. 可重复注解与类型注解

• Java8 对注解处理提供了两点改进: 可重复注解及可用于类型的注解;
• Java8 新增加两个注解的程序元素类型

  ElementType.TYPE_USE

  和

  ElementType.TYPE_PARAMETER

  ;

// 自定义注解类
@Repeatable(MyAnnotations.class)
@Target({TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation{
String value() default "annotationtest";
}

// 注解容器类
@Target({TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotations{
MyAnnotation[] value();
}

// 测试类
public class TestAnnotation{

@Test
public void test(){
Class<TestAnnotation> clazz = TestAnnotation.class;
Method m1 = clazz.getMethod("show");

// 获取 show 方法上的注解
MyAnnotation[] mas = m1.getAnnotationsByType(MyAnnotation.class);

for(MyAnnotation myAnnotation : mas){
System.out.println(myAnnotation.value());
}
}

@MyAnnotation("hello")
@MyAnnotation("world")
public void show(){

}
}

参考资料

• Java8 新特性
• Java8 特性-终极手册