Java日期相关类的使用

  

1          常用的类

1.1         Calendar

Calendar类主要提供了一个时间值和日历字段的一个对应和转换关系。这个时间值是距 历元(即格林威治标准时间1970年1月1日的00:00:00.000，格里高利历)的偏移量，是个毫秒值。

 

获取Calendar对象采用getInstance()方法，它使用了默认的时区和语言环境。

查看getInstance的JDK源代码

    public static Calendar getInstance()

    {

        Calendar cal = createCalendar(TimeZone.getDefaultRef(), Locale.getDefault());

       cal.sharedZone = true;

       return cal;

    }

 

也可以指定时区和语言环境，TimeZone和Locale

 

Calendar d1 = Calendar.getInstance();

d1.setTimeZone(TimeZone.getTimeZone("GMT+9:00"));

d1.set(Calendar.DAY_OF_MONTH,1);

 

System.out.println(d1.getTime());

输出为

Tue May 01 14:46:58 GMT+08:00 2007

当前系统时间为 15:46:58

 

Calendar的clear方法清除日历字段值和时间值

 

static  Calendar	getInstance使用默认时区和语言环境获得一个日历。()
static  Calendar	getInstance使用默认时区和指定语言环境获得一个日历。( Locale aLocale)
static  Calendar	getInstance使用指定时区和默认语言环境获得一个日历。( TimeZone zone)
static  Calendar	getInstance使用指定时区和语言环境获得一个日历。( TimeZone zone, Locale aLocale)

 

 

Calendar有两种解释日历字段的模式，即lenient和non-lenient。当Calendar处于lenient 模式时，它可接受比它所生成的日历字段范围更大范围内的值。例如

Calendar的默认模式为lenient。

Calendar d1 = Calendar.getInstance();

d1.set(Calendar.MONTH,13);

 

当Calendar处于non-lenient模式时，如果其日历字段中存在任何不一致性，它都会抛出一个异常。

Calendar d1 = Calendar.getInstance();

d1.setLenient(false);

d1.set(Calendar.MONTH,13);

程序运行后出现异常：

Exception in thread "main" java.lang.IllegalArgumentException : MONTH

    at java.util.GregorianCalendar.computeTime( GregorianCalendar.java:2315 )

    at java.util.Calendar.updateTime( Calendar.java:2260 )

    at java.util.Calendar.getTimeInMillis( Calendar.java:1044 )

    at java.util.Calendar.getTime( Calendar.java:1017 )

    at date.CalendarTest.main( CalendarTest.java:32 )

 

 

可以使用三种方法更改日历字段：set()、add() 和 roll()。

set(f, value) 将日历字段 f 更改为 value

add(f, delta) 将 delta 添加到 f 字段中。这等同于调用 set(f, get(f) + delta)，但要带以下两个调整：

Add 规则 1。调用后 f 字段的值减去调用前 f 字段的值等于 delta，以字段 f 中发生的任何溢出为模。溢出发生在字段值超出其范围时，结果，下一个更大的字段会递增或递减，并将字段值调整回其范围内。

Add 规则 2。如果期望某一个更小的字段是不变的，但让它等于以前的值是不可能的，因为在字段 f 发生更改之后，或者在出现其他约束之后，比如时区偏移量发生更改，它的最大值和最小值也在发生更改，然后它的值被调整为尽量接近于所期望的值。更小的字段表示一个更小的时间单元。HOUR 是一个比 DAY_OF_MONTH 小的字段。对于不期望是不变字段的更小字段，无需进行任何调整。日历系统会确定期望不变的那些字段。

 

roll(f, delta) 将 delta 添加到 f 字段中，但不更改更大的字段

 

 

下面是从JDK中对Calendar类的构造函数和方法的总结。

构造方法摘要
protected	Calendar构造一个带有默认时区和语言环境的 Calendar。()
protected	Calendar构造一个带有指定时区和语言环境的 Calendar。( TimeZone zone, Locale aLocale)

 

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

 

1.2         Date

Date的构造函数现在只有Date()和Date(long date)使用了，其余4个都已过时不采用了。换作使用Calendar的set方法和GregorianCalendar的构造函数。

Date的方法中用来获取和设置年，月，日，小时，分钟，秒的方法也都被Calendar的get方法所取代。转换成字符串的方法只有toString还在使用。

before、after、clone、equals、compareTo、getTime、setTime。

clone使用在不想破坏原有Date对象的数据。

 

 

下面是从JDK中对Date类的构造函数和方法的总结。

Date分配 Date 对象并初始化此对象，以表示分配它的时间（精确到毫秒）。()

Date已过时。 从 JDK 1.1 开始，由 Calendar.set(year + 1900, month, date) 或 GregorianCalendar(year + 1900, month, date) 取代。(int year, int month, int date)

Date已过时。 从 JDK 1.1 开始，由 Calendar.set(year + 1900, month, date, hrs, min) 或 GregorianCalendar(year + 1900, month, date, hrs, min) 取代。(int year, int month, int date, int hrs, int min)

Date已过时。 从 JDK 1.1 开始，由 Calendar.set(year + 1900, month, date, hrs, min, sec) 或 GregorianCalendar(year + 1900, month, date, hrs, min, sec) 取代。(int year, int month, int date, int hrs, int min, int sec)

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

Date已过时。 从 JDK 1.1 开始，由 DateFormat.parse(String s) 取代。( String s)

 

方法摘要
boolean	after测试此日期是否在指定日期之后。( Date when)
boolean	before测试此日期是否在指定日期之前。( Date when)
Object	clone返回此对象的副本。()
int	compareTo比较两个日期的顺序。( Date anotherDate)
boolean	equals比较两个日期的相等性。( Object obj)
int	getDate已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.DAY_OF_MONTH) 取代。()
int	getDay已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.DAY_OF_WEEK) 取代。()
int	getHours已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.HOUR_OF_DAY) 取代。()
int	getMinutes已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.MINUTE) 取代。()
int	getMonth已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.MONTH) 取代。()
int	getSeconds已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.SECOND) 取代。()
long	getTime返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此 Date 对象表示的毫秒数。()
int	getTimezoneOffset已过时。 从 JDK 1.1 开始，由 -(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000) 取代。()
int	getYear已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.YEAR) - 1900 取代。()
int	hashCode返回此对象的哈希码值。()
static long	parse已过时。 从 JDK 1.1 开始，由 DateFormat.parse(String s) 取代。( String s)
void	setDate已过时。 从 JDK 1.1 开始，由 Calendar.set(Calendar.DAY_OF_MONTH, int date) 取代。(int date)
void	setHours已过时。 从 JDK 1.1 开始，由 Calendar.set(Calendar.HOUR_OF_DAY, int hours) 取代。(int hours)
void	setMinutes已过时。 从 JDK 1.1 开始，由 Calendar.set(Calendar.MINUTE, int minutes) 取代。(int minutes)
void	setMonth已过时。 从 JDK 1.1 开始，由 Calendar.set(Calendar.MONTH, int month) 取代。(int month)
void	setSeconds已过时。 从 JDK 1.1 开始，由 Calendar.set(Calendar.SECOND, int seconds) 取代。(int seconds)
void	setTime设置此 Date 对象，以表示 1970 年 1 月 1 日 00:00:00 GMT 以后 time 毫秒的时间点。(long time)
void	setYear已过时。 从 JDK 1.1 开始，由 Calendar.set(Calendar.YEAR, year + 1900) 取代。(int year)
String	toGMTString已过时。 从 JDK 1.1 开始，由 DateFormat.format(Date date) 取代，使用 GMT TimeZone。()
String	toLocaleString已过时。 从 JDK 1.1 开始，由 DateFormat.format(Date date) 取代。()
String	toString把此 Date 对象转换为以下形式的 String： dow mon dd hh:mm:ss zzz yyyy 其中： dow 是一周中的某一天 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)。()
static long	UTC已过时。 从 JDK 1.1 开始，由 Calendar.set(year + 1900, month, date, hrs, min, sec) 或 GregorianCalendar(year + 1900, month, date, hrs, min, sec) 取代，使用 UTC TimeZone，后跟 Calendar.getTime().getTime()。(int year, int month, int date, int hrs, int min, int sec)

 

1.3         SimpleDateFormat

SimpleDateFormat是一个以与语言环境相关的方式来格式化和分析日期的具体类。它允许进行格式化（日期->文本）、分析（文本->日期）和规范化。

 

创建一个SimpleDateFormat，通常是 SimpleDateFormat用给定的模式和默认语言环境的日期格式符号构造 SimpleDateFormat。( String pattern)
        

 

例如将一个Date格式化为日期/时间字符串

Date date = new Date();

SimpleDateFormat df = new SimpleDateFormat("GG ww WW DD a yyyy-MM-dd hh:mm:ss zzz ZZZ");

System.out.println(df.format(date));

 

 

输出

公元 19 02 129 下午 2007-05-09 04:06:01 GMT+08:00 +0800

 

 

从给定字符串的开始分析文本，以生成一个日期

SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");

try {

       date = df.parse("2000-11-23 23:12:00");

} catch (ParseException e) {

       e.printStackTrace();

}

       System.out.println(date);

输出

Thu Nov 23 23:12:00 GMT+08:00 2000

 

模式

字母	日期或时间元素	表示	示例
G	Era 标志符	Text	AD
y	年	Year	1996; 96
M	年中的月份	Month	July; Jul; 07
w	年中的周数	Number	27
W	月份中的周数	Number	2
D	年中的天数	Number	189
d	月份中的天数	Number	10
F	月份中的星期	Number	2
E	星期中的天数	Text	Tuesday; Tue
a	Am/pm 标记	Text	PM
H	一天中的小时数（ 0-23 ）	Number	0
k	一天中的小时数（ 1-24 ）	Number	24
K	am/pm 中的小时数（ 0-11 ）	Number	0
h	am/pm 中的小时数（ 1-12 ）	Number	12
m	小时中的分钟数	Number	30
s	分钟中的秒数	Number	55
S	毫秒数	Number	978
z	时区	General time zone	Pacific Standard Time; PST; GMT-08:00
Z	时区	RFC 822 time zone	-0800

 

1.4         DateFormat

DateFormat 是日期/时间格式化子类的抽象类，它以与语言无关的方式格式化并分析日期或时间。日期/时间格式化子类（如 SimpleDateFormat）允许进行格式化（也就是日期 -> 文本）、分析（文本-> 日期）和标准化。将日期表示为 Date 对象，或者表示为从 GMT（格林尼治标准时间）1970 年，1 月 1 日 00:00:00 这一刻开始的毫秒数。

 

方法摘要
Object	clone重写 Cloneable()
boolean	equals重写 equals( Object obj)
String	format将一个 Date 格式化为日期/时间字符串。( Date date)
abstract   StringBuffer	format将一个 Date 格式化为日期/时间字符串。( Date date, StringBuffer toAppendTo, FieldPosition fieldPosition)
StringBuffer	format重写 Format。( Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition)
static  Locale[]	getAvailableLocales返回所有语言环境的数组，此类的 get*Instance 方法可以为其返回已本地化的实例。()
Calendar	getCalendar获得与此日期/时间 formatter 关联的日历。()
static  DateFormat	getDateInstance获得日期 formatter，该 formatter 具有默认语言环境的默认格式化风格。()
static  DateFormat	getDateInstance获得日期 formatter，该 formatter 具有默认语言环境的给定格式化风格。(int style)
static  DateFormat	getDateInstance获得日期 formatter，该 formatter 具有给定语言环境的给定格式化风格。(int style, Locale aLocale)
static  DateFormat	getDateTimeInstance获得日期/时间 formatter，该 formatter 具有默认语言环境的默认格式化风格。()
static  DateFormat	getDateTimeInstance获得日期/时间 formatter，该 formatter 具有默认语言环境的给定日期和时间格式化风格。(int dateStyle, int timeStyle)
static  DateFormat	getDateTimeInstance获得日期/时间 formatter，该 formatter 具有给定语言环境的给定格式化风格。(int dateStyle, int timeStyle, Locale aLocale)
static  DateFormat	getInstance获得为日期和时间使用 SHORT 风格的默认日期/时间 formatter。()
NumberFormat	getNumberFormat获得此日期/时间 formatter 用于格式化和分析时间的数字 formatter。()
static  DateFormat	getTimeInstance获得时间 formatter，该 formatter 具有默认语言环境的默认格式化风格。()
static  DateFormat	getTimeInstance获得时间 formatter，该 formatter 具有默认语言环境的给定格式化风格。(int style)
static  DateFormat	getTimeInstance获得时间 formatter，该 formatter 具有给定语言环境的给定格式化风格。(int style, Locale aLocale)
TimeZone	getTimeZone获得时区。()
int	hashCode重写 hashCode()
boolean	isLenient告知日期/时间分析是否为不严格的。()
Date	parse从给定字符串的开始分析文本，以生成一个日期。( String source)
abstract   Date	parse根据给定的分析位置开始分析日期/时间字符串。( String source, ParsePosition pos)
Object	parseObject分析字符串中的文本，以生成一个 Date。( String source, ParsePosition pos)
void	setCalendar设置此日期格式所使用的日历。( Calendar newCalendar)
void	setLenient指定日期/时间分析是否不严格。(boolean lenient)
void	setNumberFormat允许用户设置数字 formatter。( NumberFormat newNumberFormat)
void	setTimeZone为此 DateFormat 对象的日历设置时区。( TimeZone zone)

 

1.5         GregorianCalendar

GregorianCalendar 是 Calendar 的一个具体子类，提供了世界上大多数国家使用的标准日历系统。

 

构造方法摘要
GregorianCalendar在具有默认语言环境的默认时区内使用当前时间构造一个默认的 GregorianCalendar。()
GregorianCalendar在具有默认语言环境的默认时区内构造一个带有给定日期设置的 GregorianCalendar。(int year, int month, int dayOfMonth)
GregorianCalendar为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。(int year, int month, int dayOfMonth, int hourOfDay, int minute)
GregorianCalendar为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。(int year, int month, int dayOfMonth, int hourOfDay, int minute, int second)
GregorianCalendar在具有给定语言环境的默认时区内构造一个基于当前时间的 GregorianCalendar。( Locale aLocale)
GregorianCalendar在具有默认语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。( TimeZone zone)
GregorianCalendar在具有给定语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。( TimeZone zone, Locale aLocale)

 

方法摘要
void	add根据日历规则，将指定的（有符号的）时间量添加到给定的日历字段中。(int field, int amount)
Object	clone创建并返回此对象的一个副本。()
protected  void	computeFields将时间值（从 Epoch至现在的毫秒偏移量）转换为日历字段值。 ()
protected  void	computeTime将日历字段值转换为时间值（从 Epoch至现在的毫秒偏移量）。 ()
boolean	equals比较此 GregorianCalendar 与指定的 Object。( Object obj)
int	getActualMaximum考虑到给定的时间值和 getFirstDayOfWeek、 getMinimalDaysInFirstWeek、getGregorianChange 和 getTimeZone方法的当前值，返回此日历字段可能具有的最大值。 (int field)
int	getActualMinimum考虑到给定的时间值和 getFirstDayOfWeek、 getMinimalDaysInFirstWeek、getGregorianChange 和 getTimeZone方法的当前值，返回此日历字段可能具有的最小值。 (int field)
int	getGreatestMinimum返回此 GregorianCalendar 实例给定日历字段的最高的最小值。(int field)
Date	getGregorianChange获得格里高利历的更改日期。()
int	getLeastMaximum返回此 GregorianCalendar 实例给定日历字段的最低的最大值。(int field)
int	getMaximum返回此 GregorianCalendar 实例的给定日历字段的最大值。(int field)
int	getMinimum返回此 GregorianCalendar 实例的给定日历字段的最小值。(int field)
TimeZone	getTimeZone获得时区。()
int	hashCode生成此 GregorianCalendar 对象的哈希码。()
boolean	isLeapYear确定给定的年份是否为闰年。(int year)
void	roll在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。(int field, boolean up)
void	roll向指定日历字段添加有符号的时间量，不更改更大的字段。(int field, int amount)
void	setGregorianChange设置 GregorianCalendar 的更改日期。( Date date)
void	setTimeZone使用给定的时区值来设置时区。( TimeZone zone)