Java7日期时间API

作为开发者,经常需要处理日期时间。这里总结一下Java7常用的日期时间API。

Date

使用 java.util.Date 表示日期与时间,其承载了毫秒级精度的 Unix 时间。除此之外的功能(包括:承载 “年、月、日、时、分、秒” 字段,格式化,字符串解析),均标记为 @Deprecated

构造函数与常用方法

Date类支持两个构造函数,如下表所示。

编号构造函数描述
1Date()此构造函数使用当前日期和时间来初始化对象。
2Date(long millisec)此构造函数接受一个参数,该参数等于自1970年1月1日午夜以来经过的毫秒数。

以下是Date类的方法列表

编号方法描述
1boolean after(Date date)如果调用Date对象包含的日期晚于date指定的日期,则返回true,否则返回false
2boolean before(Date date)如果调用Date对象包含的日期早于date指定的日期,则返回true,否则返回false
3Object clone( )复制调用的Date对象。
4int compareTo(Date date)将调用对象的值与date的值进行比较。 如果值相等则返回0。 如果调用对象早于date,则返回负值。 如果调用对象晚于date,则返回正值。
5int compareTo(Object obj)如果obj对象是Date类对象,则与compareTo(Date)操作相同。 否则,它会抛出ClassCastException
6boolean equals(Object date)如果调用Date对象包含与date指定的时间和日期相同的时间和日期,则返回true,否则返回false
7long getTime()返回自1970年1月1日以来经过的毫秒数。
8int hashCode()返回调用对象的哈希码。
9void setTime(long time)设置时间指定的时间和日期,表示从1970年1月1日午夜开始的经过时间(以毫秒为单位)。
10String toString( )将调用Date对象转换为字符串并返回结果。
11static Date from(Instant instant)Instant对象获取一个Date的实例。jdk1.8新增
12Instant toInstant()将此Date对象转换为Instant 。jdk1.8新增

日期比较

Java使用以下三种方法来比较两个日期:

  • 使用 getTime() 方法获取两个日期(自1970年1月1日经历的毫秒数值),然后比较这两个值。
  • 使用方法 before(),after() 和 equals()。例如,一个月的12号比18号早,则 new Date(99, 2, 12).before(new Date (99, 2, 18)) 返回true。
  • 使用 compareTo() 方法,它是由 Comparable 接口定义的,Date 类实现了这个接口。

测试Date构造方法和常用方法

/**
 * 测试Date构造方法和常用方法
 */
@Test
public void testDate() {
    // 参数表示1970-01-01 00:00:00到指定时间的毫秒数
    // Sat Dec 05 12:49:59 CST 2020
    Date date1 = new Date(1607143799610L);
    System.out.println(date1);
    // 当前时间
    Date date2 = new Date();
    System.out.println(date2);

    // date1是否date2之后
    System.out.println(date1.after(date2));
    // date1和date2是否相等
    System.out.println(date1.equals(date2));
    // 返回自1970年1月1日以来经过的毫秒数
    System.out.println(date2.getTime());
}

输出结果

Sat Dec 05 12:49:59 CST 2020
Sat Dec 05 17:39:23 CST 2020
false
false
1607161163418

SimpleDateFormat

DateFormat是抽象类,能够快速地进行日期与时间的格式化输出和字符串解析,它与以语言无关的方式格式化并解析日期或时间,所以使用其子类SimpleDateFormat实现日期和字符串的相互转换。

使用SimpleDateFormat测试日期和字符串的相互转换

/**
 * 使用SimpleDateFormat测试日期和字符串的相互转换
 *
 * @throws ParseException
 */
@Test
public void testSimpleDateFormat() throws ParseException {
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    // 将字符串转化为日期
    Date date = sdf.parse("2020-12-05 16:31:39");
    System.out.println(date);

    // 将日期转化为字符串
    SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
    String str = dateFormat.format(date);
    System.out.println(str);
}

输出结果

Sat Dec 05 16:31:39 CST 2020
2020/12/05 16:31:39

DateFormat格式代码

要指定时间格式,请使用时间模式字符串。 在此模式中,所有ASCII字母都保留为模式字母,其定义如下

编号字符描述示例
1G时代指示符AD
2y四位数的年份值2019
3M月份July or 07
4d10
5h小时 A.M./P.M. (1~12)12
6H24小时制的小时表示 (0~23)22
7m分钟30
8s秒钟55
9S毫秒234
10E星期几Tuesday
11D一年中的第几天360
12F一个月中的某一天2 (second Wed. in July)
13w一年中的第几个星期40
14W一月中的第几个星期1
15aA.M./P.M. 标记PM
16k小时 (1~24)24
17K小时 A.M./P.M. (0~11)10
18z时区Eastern Standard Time
19转义文本Delimiter
20"单引号`

Calendar

相比较于 java.util.Datejava.util.Calendar 除了承载毫秒级的 Unix 时间,还承载了时区信息(默认使用系统的时区),并且,提供了诸多接口:“年、月、日、时、分、秒” 字段的获取与设置,时区设置,日期与时间的偏移调整。

从JDK1.1版本开始,在处理日期和时间时,系统推荐使用Calendar类进行实现。在设计上,Calendar类的功能要比Date类强大很多,而且在实现方式上也比Date类要复杂一些

Calendar类是一个抽象类,在实际使用时实现特定的子类的对象,创建对象的过程对程序员来说是透明的,只需要使用getInstance方法创建即可。

创建一个代表系统当前日期的Calendar对象

// 默认是当前日期
Calendar c = Calendar.getInstance();

创建一个指定日期的Calendar对象

使用Calendar类代表特定的时间,需要首先创建一个Calendar的对象,然后再设定该对象中的年月日参数来完成。

// 创建一个代表2020年6月12日的Calendar对象
Calendar c1 = Calendar.getInstance();
c1.set(2020, 6 - 1, 12);

Calendar类对象字段类型

Calendar类中用以下这些常量表示不同的意义,jdk内的很多类其实都是采用的这种思想

序号常量描述
1Calendar.YEAR年份
2Calendar.MONTH月份
3Calendar.DATE日期
4Calendar.DAY_OF_MONTH日期,和上面的字段意义完全相同
5Calendar.HOUR12小时制的小时
6Calendar.HOUR_OF_DAY24小时制的小时
7Calendar.MINUTE分钟
8Calendar.SECOND
9Calendar.DAY_OF_WEEK星期几

Calendar类对象信息的设置

set设置

Calendar c1 = Calendar.getInstance();
// 把Calendar对象c1的年月日分别设这为:2020、6、12
public final void set(int year,int month,int date)
c1.set(2020, 6-1, 12);

add设置

把c1对象的日期加上10,也就是c1也就表示为10天后的日期,其它所有的数值会被重新计算

Calendar c1 = Calendar.getInstance();
c1.add(Calendar.DATE, 10);

其他字段属性的add的意义以此类推

测试Calendar类对象信息的获得,创建一个指定日期的Calendar对象

测试Calendar类对象信息的获得,创建一个指定日期的Calendar对象

/**
 * 测试Calendar类对象信息的获得,创建一个指定日期的Calendar对象
 */
@Test
public void testCalendar() {
    Calendar c1 = Calendar.getInstance();
    // 获得年份
    int year = c1.get(Calendar.YEAR);
    // 获得月份
    int month = c1.get(Calendar.MONTH) + 1;
    // 获得日期
    int date = c1.get(Calendar.DATE);
    // 获得小时
    int hour = c1.get(Calendar.HOUR_OF_DAY);
    // 获得分钟
    int minute = c1.get(Calendar.MINUTE);
    // 获得秒
    int second = c1.get(Calendar.SECOND);
    // 获得星期几(注意(这个与Date类是不同的):1代表星期日、2代表星期1、3代表星期二,以此类推)
    int day = c1.get(Calendar.DAY_OF_WEEK);
    System.out.println("星期" + day + " " + year + "-" + month + "-" + date + " " + hour + ":" + minute + ":" + second);

    // 创建一个指定日期的Calendar对象
    Calendar c2 = Calendar.getInstance();
    c2.set(2020, (12 - 1), 5);
    System.out.println(c2.get(Calendar.YEAR) + "年" + (c2.get(Calendar.MONTH) + 1) + "月" + c2.get(Calendar.DATE) + "日");
}

输出结果

星期7 2020-12-5 17:42:47
2020年12月5日

GregorianCalendar

GregorianCalendar是Calendar类的子类,并提供世界上大多数国家/地区使用的标准日历系统。GregorianCalendar定义了两个字段:AD和BC。这是代表公历定义的两个时代。

构造函数与常用方法

下面列出GregorianCalendar对象的几个构造方法:

序号构造函数说明
1GregorianCalendar()在具有默认语言环境的默认时区内使用当前时间构造一个默认的 GregorianCalendar。
2GregorianCalendar(int year, int month, int date)在具有默认语言环境的默认时区内构造一个带有给定日期设置的 GregorianCalendar
3GregorianCalendar(int year, int month, int date, int hour, int minute)为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。
4GregorianCalendar(int year, int month, int date, int hour, int minute, int second)为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。
5GregorianCalendar(Locale aLocale)在具有给定语言环境的默认时区内构造一个基于当前时间的 GregorianCalendar。
6GregorianCalendar(TimeZone zone)在具有默认语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。
7GregorianCalendar(TimeZone zone, Locale aLocale)在具有给定语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。

这里是GregorianCalendar 类提供的一些有用的方法列表:

序号方法说明
1void add(int field, int amount)根据日历规则,将指定的(有符号的)时间量添加到给定的日历字段中。
2protected void computeFields()转换UTC毫秒值为时间域值
3protected void computeTime()覆盖Calendar ,转换时间域值为UTC毫秒值
4boolean equals(Object obj)比较此 GregorianCalendar 与指定的 Object。
5int get(int field)获取指定字段的时间值
6int getActualMaximum(int field)返回当前日期,给定字段的最大值
7int getActualMinimum(int field)返回当前日期,给定字段的最小值
8int getGreatestMinimum(int field)返回此 GregorianCalendar 实例给定日历字段的最高的最小值。
9Date getGregorianChange()获得格里高利历的更改日期。
10int getLeastMaximum(int field)返回此 GregorianCalendar 实例给定日历字段的最低的最大值
11int getMaximum(int field)返回此 GregorianCalendar 实例的给定日历字段的最大值。
12Date getTime()获取日历当前时间。
13long getTimeInMillis()获取用长整型表示的日历的当前时间
14TimeZone getTimeZone()获取时区。
15int getMinimum(int field)返回给定字段的最小值。
16int hashCode()重写hashCode.
17boolean isLeapYear(int year)确定给定的年份是否为闰年。
18void roll(int field, boolean up)在给定的时间字段上添加或减去(上/下)单个时间单元,不更改更大的字段。
19void set(int field, int value)用给定的值设置时间字段。
20void set(int year, int month, int date)设置年、月、日的值。
21void set(int year, int month, int date, int hour, int minute)设置年、月、日、小时、分钟的值。
22void set(int year, int month, int date, int hour, int minute, int second)设置年、月、日、小时、分钟、秒的值。
23void setGregorianChange(Date date)设置 GregorianCalendar 的更改日期。
24void setTime(Date date)用给定的日期设置Calendar的当前时间。
25void setTimeInMillis(long millis)用给定的long型毫秒数设置Calendar的当前时间。
26void setTimeZone(TimeZone value)用给定时区值设置当前时区。
27String toString()返回代表日历的字符串。

测试GregorianCalendar构造方法和常用方法

/**
 * 测试GregorianCalendar构造方法和常用方法
 */
@Test
public void testGregorianCalendar() {
    String months[] = {
        "Jan", "Feb", "Mar", "Apr",
        "May", "Jun", "Jul", "Aug",
        "Sep", "Oct", "Nov", "Dec"};

    int year;
    // 初始化 Gregorian 日历
    // 使用当前时间和日期
    // 默认为本地时间和时区
    GregorianCalendar gcalendar = new GregorianCalendar();
    // 显示当前时间和日期的信息
    System.out.print("Date: ");
    System.out.print(months[gcalendar.get(Calendar.MONTH)]);
    System.out.print(" " + gcalendar.get(Calendar.DATE) + " ");
    System.out.println(year = gcalendar.get(Calendar.YEAR));
    System.out.print("Time: ");
    System.out.print(gcalendar.get(Calendar.HOUR_OF_DAY) + ":");
    System.out.print(gcalendar.get(Calendar.MINUTE) + ":");
    System.out.println(gcalendar.get(Calendar.SECOND));

    // 测试当前年份是否为闰年
    if (gcalendar.isLeapYear(year)) {
        System.out.println("当前年份是闰年");
    } else {
        System.out.println("当前年份不是闰年");
    }
}

输出结果

Date: Dec 5 2020
Time: 17:33:12
当前年份是闰年

Timestamp

java.sql.Timestamp继承java.util.Date,表示1970年1月1日午夜以来经过的毫秒数时间戳。可以精度达到纳秒级,保留SQL TIMESTAMP小数秒值的功能,时间戳还提供格式化和解析操作,以支持时间戳值的JDBC转义语法。

构造方法

编号构造方法描述
1Timestamp(long time)构造一个 Timestamp 对象,使用毫秒时间值。

常用方法

编号方法描述
1booleanafter(Timestamp ts) 判断此 Timestamp 对象是否晚于给定的 Timestamp 对象。
2booleanbefore(Timestamp ts) 判断此 Timestamp 对象是否早于给定的 Timestamp 对象。
3longgetTime() 返回此 Timestamp 对象所表示的 00:00:00 GMT 以来 1970 年 1 月 1 日的毫秒数。
4StringtoString() 设置 JDBC 时间戳转义格式的时间戳的格式。
5InstanttoInstant() 将此 Timestamp 对象转换为 Instant
6LocalDateTimetoLocalDateTime() 将此 Timestamp 对象转换为 LocalDateTime

在 Java 8 之前,我们使用 java.sql.Timestamp 来表示时间戳对象,可以通过以下方式创建与获取对象:

@Test
public void testTimestamp() {
    // 利用系统标准时间创建
    Timestamp timestamp = new Timestamp(System.currentTimeMillis());
    // 获取自 1970-01-01 00:00:00 GMT 以来的毫秒数
    System.out.println(timestamp.getTime());

    // 从 Date 对象中创建
    Timestamp timestamp1 = new Timestamp((new Date()).getTime());
    System.out.println(timestamp1.toString());
}

输出结果

1607750356429
2020-12-12 13:19:16.429
已标记关键词 清除标记
相关推荐
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页