常用API - 时间日期类

Date类

概述

java.util.Date类 表示特定的瞬间，精确到毫秒。

继续查阅Date类的描述，发现Date拥有多个构造函数，只是部分已经过时，但是其中有未过时的构造函数可以把毫秒值转成日期对象。

• public Date()：分配Date对象并初始化此对象，以表示分配它的时间（精确到毫秒）。
• public Date(long date)：分配Date对象并初始化此对象，以表示自从标准基准时间（称为“历元（epoch）”，即1970年1月1日00:00:00 GMT）以来的指定毫秒数。

tips: 由于我们处于东八区，所以我们的基准时间为1970年1月1日8时0分0秒。

简单来说：使用无参构造，可以自动设置当前系统时间的毫秒时刻；指定long类型的构造参数，可以自定义毫秒时刻。例如：

package com;

import java.util.Date;

/**
 * 日期时间类
 */
public class DateTest {
    public static void main(String[] args) {
        // 空参构造函数
        Date date = new Date();
        System.out.println(date);

        // 带毫秒的long参数  毫秒转日期
        Date date1 = new Date(999999999999L);
        System.out.println(date1);

        // 日期转毫秒
        long millisecond = date.getTime();
        System.out.println(millisecond);

    }
}

tips:在使用println方法时，会自动调用Date类中的toString方法。

Date类对Object类中的toString方法进行了覆盖重写，所以结果为指定格式的字符串。

常用方法

Date类中的多数方法已经过时，常用的方法有：

方法摘要	描述+
public long getTime()	把日期对象转换成对应的时间毫秒值。
boolean after(Date when)	测试此日期是否在指定日期之后。
boolean before(Date when)	测试此日期是否在指定日期之前。
int compareTo(Date anotherDate)	比较两个日期的顺序。等于返回 0；之前返回小于 0 的值；之后返回大于 0 的值。
boolean equals(Object obj)	比较两个日期的相等性。
Object clone()	返回此对象的副本。
int hashCode()	返回此对象的哈希码值。
String toString()	把此 Date 对象转换为以下形式的 String： dow mon dd hh:mm:ss zzz yyyy 其中： dow 是一周中的某一天 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)。

​

DateFormat类

java.text.DateFormat 是日期/时间格式化子类的抽象类，

我们通过这个类可以帮我们完成日期和文本之间的转换,也就是可以在Date对象与String对象之间进行来回转换。

• 格式化：按照指定的格式，从Date对象转换为String对象。

• 解析：按照指定的格式，从String对象转换为Date对象。

构造方法

由于DateFormat为抽象类，不能直接使用，所以需要常用的子类java.text.SimpleDateFormat。

这个类需要一个模式（格式）来指定格式化或解析的标准。构造方法为：

• public SimpleDateFormat(String pattern)：用给定的模式和默认语言环境的日期格式符号构造SimpleDateFormat。

参数pattern是一个字符串，代表日期时间的自定义格式。

构造方法摘要	描述
SimpleDateFormat()	用默认的模式和默认语言环境的日期格式符号构造 SimpleDateFormat。
SimpleDateFormat(String pattern) *	用给定的模式和默认语言环境的日期格式符号构造 SimpleDateFormat。
SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)	用给定的模式和日期符号构造 SimpleDateFormat。
SimpleDateFormat(String pattern, Locale locale)	用给定的模式和给定语言环境的默认日期格式符号构造 SimpleDateFormat。

格式规则

常用的格式规则为：

标识字母（区分大小写）	含义
y	年
M	月
d	日
H	时
m	分
s	秒

常用方法

DateFormat类的常用方法有：

• public String format(Date date)：将Date对象格式化为字符串。
• public Date parse(String source)：将字符串解析为Date对象。

方法摘要	描述
Date parse(String text, ParsePosition pos)	解析字符串的文本，生成 Date。
String toPattern()	返回描述此日期格式的模式字符串。
void applyPattern(String pattern)	将给定模式字符串应用于此日期格式。
void applyLocalizedPattern(String pattern)	将给定的本地化模式字符串应用于此日期格式。
Object clone()	创建此 SimpleDateFormat 的一个副本。
boolean equals(Object obj)	比较给定对象与此 SimpleDateFormat 的相等性。
int hashCode()	返回此 SimpleDateFormat 对象的哈希码值。
StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition pos)	将给定的 Date 格式化为日期/时间字符串，并将结果添加到给定的 StringBuffer。
AttributedCharacterIterator formatToCharacterIterator(Object obj)	格式化生成 AttributedCharacterIterator 的对象。
Date get2DigitYearStart()	返回在 100 年周期内被解释的两位数字年份的开始日期。
DateFormatSymbols getDateFormatSymbols()	获取此日期格式的日期和时间格式符号的一个副本。
void set2DigitYearStart(Date startDate)	设置 100 年周期的两位数年份，该年份将被解释为从用户指定的日期开始。
void setDateFormatSymbols(DateFormatSymbols newFormatSymbols)	设置此日期格式的日期和时间格式符号。
String toLocalizedPattern()	返回描述此日期格式的本地化模式字符串。

简单使用

package com;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

public class SimpleDateFormatTest {
    public static void main(String[] args) {
        // **格式化** 日期转换为文本
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String str = dateFormat.format(new Date());
        System.out.println(str);

        //**解析** 将文本转为日期
        try {
            Date date = dateFormat.parse(str);
            System.out.println(date);
        } catch (ParseException e) {
            System.out.println("解析异常");
        }

    }
}

练习

请使用日期时间相关的API，计算出一个人已经出生了多少天。

思路：

1.获取当前时间对应的毫秒值

2.获取自己出生日期对应的毫秒值

3.两个时间相减（当前时间– 出生日期）

代码实现：

public static void function() throws Exception {
	System.out.println("请输入出生日期 格式 YYYY-MM-dd");
	// 获取出生日期,键盘输入
	String birthdayString = new Scanner(System.in).next();
	// 将字符串日期,转成Date对象
	// 创建SimpleDateFormat对象,写日期模式
	SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
	// 调用方法parse,字符串转成日期对象
	Date birthdayDate = sdf.parse(birthdayString);
	// 获取今天的日期对象
	Date todayDate = new Date();
	// 将两个日期转成毫秒值,Date类的方法getTime
	long birthdaySecond = birthdayDate.getTime();
	long todaySecond = todayDate.getTime();
	long secone = todaySecond-birthdaySecond;
	if (secone < 0){
		System.out.println("还没出生呢");
	} else {
		System.out.println(secone/1000/60/60/24);
	}
}

Calendar类

概念

java.util.Calendar是日历类，在Date后出现，替换掉了许多Date的方法。

该类将所有可能用到的时间信息封装为静态成员变量，方便获取。日历类就是方便获取各个时间属性的。

获取方式

Calendar为抽象类，由于语言敏感性，Calendar类在创建对象时并非直接创建，而是通过静态方法创建，返回子类对象。

Calendar静态方法

• public static Calendar getInstance()：使用默认时区和语言环境获得一个日历

例如：

package com;

import java.util.Calendar;

public class CalendarTest {
    public static void main(String[] args) {
        Calendar c = Calendar.getInstance();
        System.out.println(c);
    }
}

静态字段

Calendar类中提供很多成员常量，代表给定的日历字段：

字段值	含义
YEAR	年
MONTH	月（从0开始，可以+1使用）
DAY_OF_MONTH	月中的天（几号）
DATE	get 和 set 的字段数字，指示一个月中的某天。
HOUR	时（12小时制）
HOUR_OF_DAY	时（24小时制）
MINUTE	分
SECOND	秒
DAY_OF_WEEK	周中的天（周几，周日为1，可以-1使用）
DAY_OF_MONTH	get 和 set 的字段数字，指示一个月中的某天。
DAY_OF_YEAR	get 和 set 的字段数字，指示当前年中的天数。
DAY_OF_WEEK_IN_MONTH	get 和 set 的字段数字，指示当前月中的第几个星期。
AUGUST	指示在格里高利历和罗马儒略历中一年中第八个月的 MONTH 字段值。
areFieldsSet	如果 fields[] 与当前的设置时间同步，则返回 true。
APRIL	指示在格里高利历和罗马儒略历中一年中第四个月的 MONTH 字段值。
AM_PM	get 和 set 的字段数字，指示 HOUR 是在中午之前还是在中午之后。
AM	指示从午夜到中午之前这段时间的 AM_PM 字段值。
ALL_STYLES	指示所有风格名称的 getDisplayNames 的风格说明符，比如 "January" 和 "Jan"。

常用方法

根据Calendar类的API文档，常用方法有：

• public int get(int field)：返回给定日历字段的值。
• public void set(int field, int value)：将给定的日历字段设置为给定值。
• public abstract void add(int field, int amount)：根据日历的规则，为给定的日历字段添加或减去指定的时间量。
• public Date getTime()：返回一个表示此Calendar时间值（从历元到现在的毫秒偏移量）的Date对象。

方法	描述
int get(int field)	返回给定日历字段的值。 字段可以用上面的静态字段，如：Calendar.YEAR
void set(int field, int value)	将给定的日历字段设置为给定值。
abstract void add(int field, int amount)	根据日历的规则，为给定的日历字段添加或减去指定的时间量。
Date getTime()	返回一个表示此 Calendar 时间值（从历元至现在的毫秒偏移量）的 Date 对象。
boolean after(Object when)	判断此 Calendar 表示的时间是否在指定 Object 表示的时间之后，返回判断结果。
boolean before(Object when)	判断此 Calendar 表示的时间是否在指定 Object 表示的时间之前，返回判断结果。
void clear()	将此 Calendar 的所日历字段值和时间值（从历元至现在的毫秒偏移量）设置成未定义。
void clear(int field)	将此 Calendar 的给定日历字段值和时间值（从历元至现在的毫秒偏移量）设置成未定义。
Object clone()	创建并返回此对象的一个副本。
int compareTo(Calendar anotherCalendar)	比较两个 Calendar 对象表示的时间值（从历元至现在的毫秒偏移量）。
protected void complete()	填充日历字段中所有未设置的字段。
protected abstract void computeFields()	将当前毫秒时间值 time 转换为 fields[] 中的日历字段值。
protected abstract void computeTime()	将 fields[] 中的当前日历字段值转换为毫秒时间值 time。
boolean equals(Object obj)	将此 Calendar 与指定 Object 比较。
int getActualMaximum(int field)	给定此 Calendar 的时间值，返回指定日历字段可能拥有的最大值。
int getActualMinimum(int field)	给定此 Calendar 的时间值，返回指定日历字段可能拥有的最小值。
static Locale[] getAvailableLocales()	返回所有语言环境的数组，此类的 getInstance 方法可以为其返回本地化的实例。
String getDisplayName(int field, int style, Locale locale)	返回给定 style 和 locale 下的日历 field 值的字符串表示形式。
Map<String,Integer> getDisplayNames(int field, int style, Locale locale)	返回给定 style 和 locale 下包含日历 field 所有名称的 Map 及其相应字段值。
int getFirstDayOfWeek()	获取一星期的第一天；例如，在美国，这一天是 SUNDAY，而在法国，这一天是 MONDAY。
abstract int getGreatestMinimum(int field)	返回此 Calendar 实例给定日历字段的最高的最小值。
static Calendar getInstance()	使用默认时区和语言环境获得一个日历。
static Calendar getInstance(Locale aLocale)	使用默认时区和指定语言环境获得一个日历。
static Calendar getInstance(TimeZone zone)	使用指定时区和默认语言环境获得一个日历。
static Calendar getInstance(TimeZone zone, Locale aLocale)	使用指定时区和语言环境获得一个日历。
abstract int getLeastMaximum(int field)	返回此 Calendar 实例给定日历字段的最低的最大值。
abstract int getMaximum(int field)	返回此 Calendar 实例给定日历字段的最大值。
int getMinimalDaysInFirstWeek()	获取一年中第一个星期所需的最少天数，例如，如果定义第一个星期包含一年第一个月的第一天，则此方法将返回 1。
abstract int getMinimum(int field)	返回此 Calendar 实例给定日历字段的最小值。
long getTimeInMillis()	返回此 Calendar 的时间值，以毫秒为单位。
TimeZone getTimeZone()	获得时区。
int hashCode()	返回该此日历的哈希码。
protected int internalGet(int field)	返回给定日历字段的值。
boolean isLenient()	判断日期/时间的解释是否为宽松的。
boolean isSet(int field)	确定给定日历字段是否已经设置了一个值，其中包括因为调用 get 方法触发内部字段计算而导致已经设置该值的情况。
abstract void roll(int field, boolean up)	在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。
void roll(int field, int amount)	向指定日历字段添加指定（有符号的）时间量，不更改更大的字段。
void set(int year, int month, int date)	设置日历字段 YEAR、MONTH 和 DAY_OF_MONTH 的值。
void set(int year, int month, int date, int hourOfDay, int minute)	设置日历字段 YEAR、MONTH、DAY_OF_MONTH、HOUR_OF_DAY 和 MINUTE 的值。
void set(int year, int month, int date, int hourOfDay, int minute, int second)	设置字段 YEAR、MONTH、DAY_OF_MONTH、HOUR、MINUTE 和 SECOND 的值。
void setFirstDayOfWeek(int value)	设置一星期的第一天是哪一天；例如，在美国，这一天是 SUNDAY，而在法国，这一天是 MONDAY。
void setLenient(boolean lenient)	指定日期/时间解释是否是宽松的。
void setMinimalDaysInFirstWeek(int value)	设置一年中第一个星期所需的最少天数，例如，如果定义第一个星期包含一年第一个月的第一天，则使用值 1 调用此方法。
void setTime(Date date)	使用给定的 Date 设置此 Calendar 的时间。
void setTimeInMillis(long millis)	用给定的 long 值设置此 Calendar 的当前时间值。
void setTimeZone(TimeZone value)	使用给定的时区值来设置时区。
String toString()	返回此日历的字符串表示形式。

简单使用

package com;

import java.util.Calendar;

/**
 * Calendar类的常用方法
 * 根据Calendar类的API文档，常用方法有：
 * public int get(int field)：返回给定日历字段的值。
 * public void set(int field, int value)：将给定的日历字段设置为给定值。
 * public abstract void add(int field, int amount)：根据日历的规则，为给定的日历字段添加或减去指定的时间量。
 * public Date getTime()：返回一个表示此Calendar时间值（从历元到现在的毫秒偏移量）的Date对象。
 */
public class CalendarTest {
    public static void main(String[] args) {
        Calendar c = Calendar.getInstance();

        // get 获取日历的某个字段
        System.out.println(c.get(Calendar.YEAR));
        // 月份从0开始
        System.out.println(c.get(Calendar.MONTH));
        System.out.println(c.get(Calendar.DAY_OF_YEAR));

        // set 设置日历的某个字段
        c.set(Calendar.YEAR,1995);
        System.out.println(c.getTime());
        c.set(1999, Calendar.DECEMBER, 1);
        System.out.println(c.getTime());

        // add 修改指定的字段，可以是整数也可以是负数
        System.out.println("======add 加减=====");
        c.add(Calendar.YEAR,10);
        System.out.println(c.getTime());

        // getTime 将日历转为日期Date
    }
}

小贴士：

​ 西方星期的开始为周日，中国为周一。

​ 在Calendar类中，月份的表示是以0-11代表1-12月。

​ 日期是有大小关系的，时间靠后，时间越大。