时间类

导读:
  1. 本文分为两部分,分别时jdk8前后的时间类的交替更新,下面表为新旧类对应情况

主要功能

jdk8之前

jdk8之后(java.time包)

日期/毫秒数

Date(分为java.util.Date/java.sql.Date)

Instant

获取/修改

Calendar

LocalDateTime/LocalDate/LocalTime

格式化/解析

SimpleDateFormat

DateTimeFormat

  1. 主要讲述了各类的实例化方式和常用方法
一、System类
// 时间戳
  @Test
      public void test1(){
          // 从北京时间1970年1月1日08时00分00秒至今共计的毫秒数,输出为:1636943118349ms  
          long time1 = System.currentTimeMillis();        
          System.out.println(time1);
      }
  • UTC :统一的标准时间
    GMT :格林尼治标准时间
    CST :可视为中国、美国、澳大利亚或古巴的标准时间。
二、Data类
java.util.Date类(父类)

对应的是日常开发中常用的日期类型数据(日期类型变量) java.util_百度百科

两个构造器

① new Date( ):创建一个对应当前时间的 Date 对象

② new Date(long millisecond):创建一个指定毫秒数的 Date 对象

两个方法

① toString( ):显示 年、月、日、时、分、秒

② getTime( ):返回long型毫秒数,从**UTC时间1970年1月1日00时00分00秒(对应北京时间为1970年1月1日08时00分00秒)**至今,和时间戳功能一致(对应格林尼治时间为1970年1月1日00时00分00秒)

@Test
    public void test2(){
        // 1.创建对应当前时间的Date对象
        Date d1 = new Date();
        // 1.1 输出年月日的时间格式  Sun Dec 19 11:34:25 CST 2021
        System.out.println(d1.toString());
        // 1.2 输出毫秒数的时间格式  1639884865965
        System.out.println(d1.getTime());

        // 2.创建指定毫秒数的Date对象
        Date d2 = new Date(160003034L);
        // 2.1 输出指定毫秒数所对应的年月日时间格式  Sat Jan 03 04:26:43 CST 1970
        System.out.println(d2.toString());
    }
java.sql.Date类(子类)

对应着数据库中的日期类型数据(日期类型变量) java.sql_百度百科

  • 就一个构造器
    new java.sql.Date ( Long millisecond ):创建一个指定毫秒数的 Date 对象
  • 方法
    toString():输出年、月、日
java.util.Date 类型 与 java.sql.Date 类型互转
@Test
    public void test2(){
		// 实例化
        java.sql.Date d1 = new java.sql.Date(15559304943L);
        // 因为构造器中就是毫秒数,所以就没有getTime()方法了
        System.out.println(d3.toString()); 
        
        // 1.子类转父类(多态),直接赋值即可  java.sql.Date - - > java.util.Date
        Date d2 = d1;        
		
        // 2.父类转子类  java.util.Date - - > java.sql.Date
        // 2.1 基于多态的强制类型转换
        java.sql.Date d3 = (java.sql.Date)d2
        // 2.2 用Date类中的getTime方法,使Date类型对象转换为毫秒传入java.sql.Date的构造器中
        Date d5 = new Date();
        java.sql.Date d6 = new java.sql.Date(d5.getTime());

    }
三、SimpleDateFormat类
两个方法
  • format():格式化 Date类型数据 - - > 字符串
  • parse(): 解析 字符串 - - > Date类型数据
两个操作(针对 Date类型变量)
  • 默认格式操作
  • 带参数指定格式操作(该情况下的解析,字符串必须符合指定格式)
@Test
    public void test3() throws ParseException {
        // 1.默认实例化
        SimpleDateFormat sdf1 = new SimpleDateFormat();

        // 1.1 格式化:将Date类型数据转变为字符串
        Date date = new Date();
        // 将新建的日期对象传入默认实例化的SimpleDateFormat对象中,转变为默认格式的字符串 yyyy/MM/dd 上/下午hh:mm
        String format1 = sdf1.format(date);
        // 输出字符串为:2021/12/18 下午6:19
        System.out.println(format1);

        // 1.2 解析:将字符串转换为Date类型数据
        String str = "2021/11/15 下午3:41";
        // 将与SimpleDateFormat中默认日期格式相符合的字符串转换为Date类型数据
        Date parse1 = sdf1.parse(str);
        // 输出Date类型数据为:Mon Nov 15 15:41:00 CST 2021
        System.out.println(parse1);

        // 2.带参数的实例化
        SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        // 2.1 将Date类实例对象作为实参传入SimpleDateFormat重载构造器中,转换为自定义参数格式的字符串
        String format2 = sdf2.format(parse1);
        // 输出字符串为:2021-11-15 15:41:00
        System.out.println(format2);

        // 2.2 将与SimpleDateFormat类的实例对象中自定义参数格式相符和的字符串解析为Date类型数据
        Date parse2 = sdf2.parse("2021-11-15 16:11:27");
        // 输出Date类型数据为:Mon Nov 15 16:11:27 CST 2021
        System.out.println(parse2);
    }
}
四、Date类和SimpleDateFormat类的小练习
将字符串 “2021-11-15” 转换为 java.sql.Date
@Test
    public void test4() throws ParseException {        
        SimpleDateFormat sf1 = new SimpleDateFormat("yyyy-MM-dd");
        String str = "2021-11-15";
        // 1.解析:将字符串转换为Date类型变量
        Date p = sf1.parse(str);	
        // 2.java.util.date - - > java.sql.date
        java.sql.Date d = new java.sql.Date(p.getTime());
        System.out.println(d);
    }
五、Calendar类(日历类)
  • JDK1.0中就包含了java.util.Date类,但是它的大多数方法已经在JDK1.1引入Calendar类之后被弃用了
  • 主要完成日期字段之间相互操作的功能,可通过setTime方法将Date类型变量转换为Calendar类型变量,通过get方法得知此刻是一年中的第几天、一月中的第几天等,或者通过set方法设置此刻时间变为一年中的指定天数等
实例化(抽象类)
  • 方式一:创建其子类的实例化
// GregorianCalendar类是其子类
GregorianCalendar gre1 = new GregorianCalendar();

// GregorianCalendar类的源码
public class GregorianCalendar extends Calendar {}
  • 方式二:通过调用其静态方法getInstance实例化
// 调用其getInstance方法
Calendar instance = Calendar.getInstance();

// 源码:返回一个Calender对象
   public static Calendar getInstance()
   {
        return createCalendar(TimeZone.getDefault(), 
                              Locale.getDefault(Locale.Category.FORMAT));
   }
常用方法
  • get( static final int )
// get()方法的形参是Calendar类中的静态整型常量
// 1.返回此刻是本年度的第几天   312
int days = instance.get(Calendar.DAY_OF_YEAR);
System.out.println(days);	
// 2.返回此刻是本月的第几天   16
days = instance.get(Calendar.DAY_OF_MONTH);
System.out.println(days);

:WEEK:周日返回的是 1,周一返回的是 2 。。。

MOUTH:1月返回的是 0,2月返回的是 1 。。。

  • set( ) - - > Calendar类的可变性
// set()方法中的第二个参数可以把Calendar类中的静态常量值改变
instance.set(Calendar.DAY_OF_YEAR,10);
// 再次调用get()方法后返回的是更改后的值   10
int days1 = instance.get(Calendar.DAY_OF_YEAR);
System.out.println(days1);
  • add( )
// 在set方法的基础上进行增减,如果要减,就把数字写为负数  
instance.add(Calendar.DAY_OF_YEAR,3);
// get方法的返回值为 13
days = instance.get(Calendar.DAY_OF_YEAR);
System.out.println(days);
  • getTime( ) :Calendar 类 - - > Date类
// 得到的Date类型变量是Calendar对象经过修改后的时间
Date time = instance.getTime();	
// 输出为Wed Nov 13 15:25:59 CST 2021
System.out.println(time);			  
// getTime方法的源码
public final Date getTime() {
    return new Date(getTimeInMillis());
}
  • setTime( ): Date类 - - > Calendar 类
// 新建Date类实例化对象
Date date = new Date();
// 通过Calendar实例对象instance调用setTime将Date类型变量转变为Calendar类型变量
instance.setTime(date);
// 通过该Calendar实例对象调用get方法得知传入Date类型变量是一年中的第几天等信息
System.out.println(instance.get(Calendar.DAY_OF_MONTH));
六、Date类 和 Calendar类面临的问题

JDK1.0中就包含了java.util.Date类,但是它的大多数方法已经在JDK1.1引入Calendar类之后就弃用了。但是Calendar类也面临如下问题:

  1. 可变性:日期和时间这样的类应该是不可变的
  2. 偏移性:Date类中的年份是从1900年开始的,而月份是从0开始的
  3. 格式化:格式化只对Date有用,Calendar则不行
  4. 安全性:它们都是线程不安全的,不能处理闰秒问题
  5. 为了解决上述问题,Java8 吸收了第三方Joda - Time的精华,创建了新的 java.time
七、java.time包 ( jdk8之后 )
  • java.time中包含了所有关于本地日期(LocalDate)、本地时间(LocalTime)、本地日期时间(LocalDateTime)、时区(ZonedDateTime)和持续时间(Duration)的类。历史悠久的Date类新增了toInstance( ) 方法,用于把Date类型变量转换为新的表示形式。新增的API大大简化了日期时间和本地化的管理。
  • 新日期API
  • java.time:包含值对象的基础包
  • java.time.chrono:提供对不同的日历系统的访问
  • java.time.format:格式化和解析时间和日期
  • java.time.temporal:包括底层框架和扩展特性
  • java.time.zone:包含时区支持的类
LocalDate、LocalTime、LocalDateTime 类

这三个类是其中必要重要的类,它们的实例对象是不可变的,分别表示使用 [ISO 8601](https://baike.baidu.com/item/ISO 8601/3910715?fr=aladdin)日历系统的日期、时间、日期和时间。它们提供了简单的本地日期和时间,并不包含当前的时间信息,也不包含与时区相关的信息

  • LocalDate:代表IOS格式(yyyy-MM-dd)的日期,可以存储生日、纪念日等日期
  • LocalTime:表示一个时间,而不是日期
  • LocalDateTime:用来表示日期和时间,这是一个最常用的类
  • 方法表的一系列方法类似Calendar类中的方法,其中也有withXxx、plusXxx等系列方法可以在调用对象的基础上进行时间修改,但是这些系列方法会返回一个对应类的新对象调用类中的时间不会改变,体现了java.time包这三个新引入类的不可变性
  • 代码示例
@Test
    public void test(){
        // 1.实例化
        // 1.1 使用now()方法对三个类分别进行实例化
        LocalDate localDate = LocalDate.now();
        LocalTime localTime = LocalTime.now();
        LocalDateTime localDateTime = LocalDateTime.now();
		// LocalDate对象的输出格式:2021-11-16
        System.out.println(localDate);  
        // LocalTime对象的输出格式:16:52:05.621 (621表示毫秒)
        System.out.println(localTime); 
        // LocalDateTime对象的输出格式:2021-11-16T16:52:05.621
        System.out.println(localDateTime);  

        // 1.2 使用of()方法进行实例化,可以传入制定日期作为实参
        LocalDateTime localDateTime1 = LocalDateTime.of(2022, 1, 1, 8, 8, 8);
        // 输出格式为:2022-01-01T08:08:08
        System.out.println(localDateTime1);

        // 2.getXxx()系列获取方法
        // 2.1 getDayOfYear:此刻为一年中的第几天  320
        System.out.println(localDateTime.getDayOfYear());
        // 2.2 getDayOfMonth:此刻为一月中的第几天  16
        System.out.println(localDateTime.getDayOfMonth());  
        // 2.3 getDayOfWeek:此刻为一周中的星期几  TUESDAY
        System.out.println(localDateTime.getDayOfWeek());   
        // 2.4 getMonthValue:此刻为几月份  11
        System.out.println(localDateTime.getMonthValue()); 
        // 2.5 getYear:此刻为公历哪年  2021
        System.out.println(localDateTime.getYear());
        // 2.6 getMonth:此刻为几月份,返回枚举值  NOVEMBER
        System.out.println(localDateTime.getMonth());  
        // 2.7 getHour:此刻对应的小时  17
        System.out.println(localDateTime.getHour()); 
        // 2.8 getMinute:此刻对应的分钟  5
        System.out.println(localDateTime.getMinute());
        // 2.9 getSecond:此刻对应的秒  2
        System.out.println(localDateTime.getSecond());     

        // 3.withXxx()系类设置方法
        // 此刻时间为2021-11-16T17:18:40.594(用作对比参考)
        System.out.println(localDateTime);  
        // 3.1 将此刻时间设置为本年度的第一天  2021-01-01T17:18:40.594
        System.out.println(localDateTime.withDayOfYear(1)); 
        // 3.2 将此刻时间设置为本月份的第一天  2021-11-01T17:18:40.594
        System.out.println(localDateTime.withDayOfMonth(1));
        // 3.3 将此刻时间中的年份进行设置  2022-11-16T17:18:40.594 
        System.out.println(localDateTime.withYear(2022));   
        // 3.4 将此刻时间中的月份进行设置  2021-01-16T17:18:40.594
        System.out.println(localDateTime.withMonth(1));      
        // 3.5 将此刻时间中的小时进行设置  2021-11-16T08:18:40.594
        System.out.println(localDateTime.withHour(8));      
        // 3.6 将此刻时间中的分钟进行设置  2021-11-16T17:08:40.594
        System.out.println(localDateTime.withMinute(8));    
        // 3.7 将此刻时间中的秒进行设置    2021-11-16T17:18:08.594
        System.out.println(localDateTime.withSecond(8));     
        // 3.8 将此刻时间中的纳秒进行设置  2021-11-16T17:18:40.000000888
        System.out.println(localDateTime.withNano(888));     

        // 4.plusXxx()系列增加时间的方法
        // 此刻时间为2021-11-16T17:25:36.199(用作对比参考)
        System.out.println(localDateTime);                  
        // 4.1 将此刻时间增加年份  2022-11-16T17:25:36.199
        System.out.println(localDateTime.plusYears(1)); 
        // 4.2 将此刻时间增加月份  2021-12-16T17:25:36.199
        System.out.println(localDateTime.plusMonths(1));    
        // 4.3 将此刻时间增加周数  2021-11-23T17:25:36.199
        System.out.println(localDateTime.plusWeeks(1));    
        // 4.4 将此刻时间增加天数  2021-11-22T17:25:36.199
        System.out.println(localDateTime.plusDays(6));     
        // 4.5 将此刻时间增加小时  2021-11-16T19:25:36.199
        System.out.println(localDateTime.plusHours(2));     
        // 4.6 将此刻时间增加分钟  2021-11-16T19:30:36.199
        System.out.println(localDateTime.plusMinutes(5));   
        // 4.7 将此刻时间增加秒数  2021-11-16T19:25:41.199
        System.out.println(localDateTime.plusSeconds(5));   
        // 4.8 将此刻时间增加纳秒  2021-11-16T19:25:36.199000888
        System.out.println(localDateTime.plusNanos(888));   
        
        // 5.minusXxx()系列减少时间的方法
        // 此刻时间为:2021-11-16T17:39:36.321(用作参考)
        System.out.println(localDateTime); 
        // 5.1 将此刻时间减少年份 2016-11-16T17:39:36.321
        System.out.println(localDateTime.minusYears(5));         
        // 5.2 将此刻时间减少月份 2016-11-16T17:39:36.321
        System.out.println(localDateTime.minusMonths(60));        
        // 5.3 将此刻时间减少周数 2016-11-16T17:39:36.321
        System.out.println(localDateTime.minusWeeks(260));       
        // 5.4 将此刻时间减少天数 2016-11-16T17:39:36.321
        System.out.println(localDateTime.minusDays(1826));        
        // 5.5 将此刻时间减少分钟 2016-11-16T17:39:36.32116T17:39:36.321
        System.out.println(localDateTime.minusMinutes(2629440));  
        // 5.6 将此刻时间减少秒数 2016-11-16T17:39:36.321
        System.out.println(localDateTime.minusSeconds(157766400));
        // 5.7 将此刻时间减少纳秒 2021-11-16T17:39:35.432111112
        System.out.println(localDateTime.minusNanos(888888888)); 
    }
Instant类

瞬时类、时间线上的一个瞬时点。这可能被用来记录应用程序中的事件时间戳。因为其单纯表示时间线上的一个点,故不需要任何上下文的信息,计时从(UTC)1970年1月1日0时0分0秒开始的秒数,可以精确到纳秒(1s = 10^9ns)。

  • 方法表
  • 代码示例
@Test
    public void test1(){
        // 1.实例化方式一:通过静态方法now(),获得UTC(本初子午线)的此刻瞬时时间的实例对象
        Instant instant = Instant.now();
        // 输出为:2021-11-16T14:25:36.466121700Z(Z表示本初子午线)
        System.out.println(instant);
		// 2.实例化方式二:通过毫秒方法,返回Instant类实例对象
        Instant instant1 = Instant.ofEpochMilli(1637073095658L);
        // 输出为:2021-11-16T14:31:35.658Z
        System.out.println(instant1);
 
        // 3.通过atOffset方法对时间进行时区偏移修正,北京时间应该+8
        OffsetDateTime offsetDateTime = instant.
            						atOffset(ZoneOffset.ofHours(8));
        // 输出为:2021-11-16T22:25:36.466121700+08:00(Z变为+8:00)
        System.out.println(offsetDateTime);

       
        // 获取自1970年1月1日00时00分00秒至此刻的毫秒值,与Date类的getTime方法类似
        long milli = instant.toEpochMilli();
        // 输出为:1639884865965
        System.out.println(milli);

    }
DateTimeFormatter类

对标 SimpleDateFormat

  • 实例方式一:预定义格式 - - .ISO_XXX_XXX_XXX
@Test
    public void test2(){
        // 1.用预定义格式创建一个DateTimeFormatter类的实例对象
        DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
        // 2.获取该实例对象对应的日期类的实例对象
        LocalDateTime localDateTime = LocalDateTime.now();
        // 3.格式化:将该日期类的实例对象转变为String类变量
        String str = formatter.format(localDateTime);
        // 输出为:2021-12-19T11:54:21.7387001
        System.out.println(str);
        // 4.解析:将与DateTimeFormatter类的实例对象对应日期类格式相符的字符串变量转换为对应日期格式
        TemporalAccessor parse = formatter.parse("2021-11-17T09:07:15.961");
        // 输出为:{},ISO resolved to 2021-11-17T09:07:15.961
        System.out.println(parse);

        // 对应的日期类不同,操作与上述步骤相同
        DateTimeFormatter formatter1 = DateTimeFormatter.ISO_LOCAL_DATE;
        LocalDate localDate = LocalDate.now();
        String str2 = formatter1.format(localDate);
        System.out.println(str2);
        TemporalAccessor parse1 = formatter1.parse("2021-11-17");
        System.out.println(parse1);
    }
  • 实例方式二:本地化格式 - - ofLocalizedDateTime(FormatStyle.XXX)
// jdk8下的运行代码
@Test
    public void test1() {
        // FormatStyle.XXX  有LONG、MEDIUM、SHORT三种格式
        DateTimeFormatter formatter2 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG);
        LocalDateTime localDateTime = LocalDateTime.now();
        // 格式化 2021年12月19日 下午12时17分10秒
        String s = formatter2.format(localDateTime);
        System.out.println(s);
        // 解析 {},ISO resolved to 2021-11-17T20:47:52
        TemporalAccessor parse2 = formatter2.parse("2021年11月17日 下午08时47分52秒");
        System.out.println(parse2);
    }

// jdk11下的运行代码
@Test
    public void test3() {
        // ofLocalizedDateTime(FormatStyle.XXX).withZone(ZoneId.systemDefault())
        DateTimeFormatter formatter2 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG).withZone(ZoneId.systemDefault());
        LocalDateTime localDateTime = LocalDateTime.now();
        // 格式化 2021年12月19日 CST 下午12:13:46
        String s = formatter2.format(localDateTime);
        System.out.println(s);
        // 解析 {InstantSeconds=1637203672},ISO,America/Chicago resolved to 2021-11-17T20:47:52
        TemporalAccessor parse2 = formatter2.parse("2021年11月17日 CST 下午08:47:52");
        System.out.println(parse2);
    }
}
  • 实例方式三:自定义格式 - - ofPatter(“yy-MM-dd h-m-s”) 常用方式
@Test
    public void test3() {
        // ofPatter("yy-MM-dd h-m-s")
        DateTimeFormatter formatter3 = DateTimeFormatter.ofPattern("yyyy-MM-dd k:m:s");
        // 1.格式化:按照自定义格式将日期类变量转变为字符串
        String s1 = formatter3.format(LocalDateTime.now());
        // 输出为:2021-12-19 15:26:27
        System.out.println(s1);
        // 2.解析:将与自定义格式相符的字符串变量转变为日期类型变量
        TemporalAccessor parse3 = formatter3.parse("2021-11-17 20:58:40");
        // 输出为:{},ISO resolved to 2021-11-17T20:58:40
        System.out.println(parse3);
    }