Java 8 Date/Time API

红太狼 2023-10-07 23:54 2阅读 0赞

## 1.为什么需要新的java date api ##

先看下java8之前的date api有哪些问题？

*  在 java.util 和 java.sql 包中都有日期类
 *  java.util.Date 包含日期和时间值，而 java.sql.Date 仅包含日期值。这两个类具有相同的名称，这本身就是一个非常糟糕的设计
 *  没有明确定义的时间、时间戳、格式和解析类。我们有用于解析和格式化需要的 java.text.DateFormat 抽象类。通常，SimpleDateFormat 类用于解析和格式化。
 *  所有 Date 类都是可变的，因此它们不是线程安全的，这是 Java Date 和 Calendar 类的最大问题之一。
 *  Date 类不提供国际化，不支持时区。

## 2.Java 8 Date Time设计原则 ##

*  不可变性：新的 Date-Time API 中的所有类都是不可变的，并且适用于多线程环境。
 *  关注点分离：新的 API 清楚地区分了人类可读的日期时间和机器时间（Unix 时间戳）。它为 Date、Time、DateTime、Timestamp、Timezone 等定义了单独的类。
 *  明确性：所有方法被明确定义并在所有类中执行相同的操作。例如，要获取当前实例，我们有 now() 方法。所有这些类中都定义了 format() 和 parse() 方法，而不是为它们创建一个单独的类。
 *  有效的操作：新的Date-Time API 中有诸如plus, minus, format, parsing, getting的有效操作
 *  扩展性：新的日期时间 API 适用于 ISO-8601 日历系统，但我们也可以将其与其他非 ISO 日历一起使用。

## 3.Java 8 Date Time API包 ##

1.  java.time：新的Date Time API的基础包，包含LocalDate LocalDateTime Instant等等。所有的类都是线程安全的，足够满足大多数情况的需求。
2.  java.time.chrono：定义了通用的非 ISO 日历系统的API
3.  java.time.format：这个包主要是一些关于解析和格式化的类
4.  java.time.temporal：用于找到一些特定日期和时间的包，比如本月第一天这种
5.  java.time.zone Package：时区相关的包

## 4.Java 8 Date Time API简介和一些例子 ##

### 4.1 LocalDate ###

//今天
    LocalDate today = LocalDate.now();
    
    //明天
    LocalDate tomorrow = LocalDate.now().plusDays(1);
    //上个月的今天 特定枚举
    LocalDate previousMonthSameDay = LocalDate.now().minus(1, ChronoUnit.MONTHS);
    
    //DayOfWeek为枚举类，返回周几的枚举值 SATURDAY
    DayOfWeek saturday = LocalDate.parse("2022-07-30").getDayOfWeek();
    
    //当月的第几天
    int twelve = LocalDate.parse("2022-07-30").getDayOfMonth();
    
    //是否闰年
    boolean leapYear = LocalDate.now().isLeapYear();
    
    
    boolean notBefore = LocalDate.parse("2022-07-30")
                    .isBefore(LocalDate.now());
    
    boolean isAfter = LocalDate.parse("2022-07-30")
                    .isAfter(LocalDate.now());
    
    //当前天的开头即0点0分0秒
    LocalDateTime beginningOfDay = LocalDate.parse("2022-07-30").atStartOfDay();
    //月初
    LocalDate firstDayOfMonth = LocalDate.parse("2022-07-30")
      .with(TemporalAdjusters.firstDayOfMonth());
    
    
    //指定年月日
    LocalDate specialDay = LocalDate.of(2022, Month.JULY, 9);
    
    LocalDate.parse("2015-02-20");
    
    //1970-01-01之后的时间
    LocalDate epochDay = LocalDate.ofEpochDay(1L);
    
    //某年的第几天
    LocalDate thisYearDay = LocalDate.ofYearDay(2022, 2);
    
    //相隔时间
    LocalDate initialDate = LocalDate.parse("2007-05-10");
    LocalDate finalDate = initialDate.plus(Period.ofDays(5));
    int five = Period.between(initialDate, finalDate).getDays();
    long five = ChronoUnit.DAYS.between(initialDate, finalDate);

### 4.2 LocalTime ###

//当前的时分秒
            LocalTime now = LocalTime.now();
            //指定时间
            LocalTime sixThirty = LocalTime.parse("06:30");
            LocalTime ofTime = LocalTime.of(14, 9, 20);
    
    
            LocalTime sevenThirty = LocalTime.parse("06:30").plus(1, ChronoUnit.HOURS);
    
            //获取小时
            int six = LocalTime.parse("06:30").getHour();
            
            //比较前后
            boolean isbefore =     
            LocalTime.parse("06:30").isBefore(LocalTime.parse("07:30"));
            //今天的结尾
            LocalTime maxTime = LocalTime.MAX;
    
            //指定时区的时间
            LocalTime timeKolkata = LocalTime.now(ZoneId.of("Asia/Kolkata"));
    
            //今天开始的第几秒的时间
            LocalTime secondOfDayTime = LocalTime.ofSecondOfDay(1L);

### 4.3 LocalDateTime ###

//当前的年月日时分秒 yyyy-MM-ddTHH-mm-ss.zzz
            LocalDateTime now = LocalDateTime.now();
            LocalDateTime nowTime = LocalDateTime.of(LocalDate.now(), LocalTime.now());
            //特定枚举
            LocalDateTime.of(2015, Month.FEBRUARY, 20, 06, 30);
            LocalDateTime.parse("2015-02-20T06:30:00");
            LocalDateTime ofDateTime = LocalDateTime.of(2022, 7, 15, 20, 00);
    
            //时区
            LocalDateTime todayKolkata = LocalDateTime.now(ZoneId.of("Asia/Kolkata"));
            
            //时间的加减
            LocalDateTime.now().plusDays(1);
            LocalDateTime.now().minusHours(2);
            //月份
            LocalDateTime.now().getMonth();
    
            //date from BaseTime
            LocalDateTime dateFromBase = LocalDateTime.ofEpochSecond(10000, 0,     
            ZoneOffset.UTC);

### 4.4 ZoneId ###

//时区相关
    //所有时区 java.time.ZoneId#SHORT_IDS
    ZoneId zoneId = ZoneId.of("Europe/Paris");
    
    Set<String> allZoneIds = ZoneId.getAvailableZoneIds();
    
    //2022-07-26T14:57:50.381+02:00[Europe/Paris]
    ZonedDateTime zonedDateTime = ZonedDateTime.of(LocalDateTime.now(), zoneId);
    
    ZonedDateTime parse = ZonedDateTime.parse("2015-05-03T10:15:30+01:00[Europe/Paris]");

### 4.5.Instant ###

//Instant class is used to work with machine readable time format. 
            //Instant stores date time in unix timestamp.
            Instant now = Instant.now();
            System.out.println(now);
    
            //Instant from timestamp 
            // epochMilli – the number of milliseconds from 1970-01-01T00:00:00Z
            Instant specificTime = Instant.ofEpochMilli(now.toEpochMilli());
            System.out.println("Specific Time = "+specificTime);
    
            //Duration:A time-based amount of time, such as '34.5 seconds'.
            Duration thirtyDay = Duration.ofDays(1);
            System.out.println(thirtyDay);

### 4.6 一些常见病的转换demo ###

//Date转localDateTime
    Date date = new Date();
    LocalDateTime nowByDate = LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());
    
    //LocalDateTime转Date
    Date.from(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant());
    
    Date.from(LocalDateTime.of(LocalDate.now(), LocalTime.now())
              .atZone(ZoneId.systemDefault()).toInstant());
    
    
    //Calendar转LocalDateTime
    Calendar calendar = Calendar.getInstance();
    LocalDateTime nowByCalendar = LocalDateTime.ofInstant(calendar.toInstant(), ZoneId.systemDefault());
    
    //localDateTime转string
    String format = localDateTime.format(DateTimeFormatter.ofPattern("YYYY-MM-DD HH:mm:ss"));
    String format = localDateTime.format(DateTimeFormatter.ISO_DATE);
    
    //当前周
    LocalDate today = LocalDate.now();
    LocalDate monday = today.with(TemporalAdjusters.previousOrSame( DayOfWeek.MONDAY));
    LocalDate sunday = today.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY ));
    
    //localdate转date
    public Date convertDate(LocalDate localDate){
            return Date.from(localDate.atStartOfDay(ZoneId.systemDefault()).toInstant());
        }

以上是对java8Date/Time API的总结和拙见，希望能对你有所帮助。