Date、Calendar、DateFormat、SimpleDateFormat、Timer、TimerTask类

类 Date

在 JDK 1.1 之前，类 Date 有两个其他的函数。它允许把日期解释为年、月、日、小时、分钟和秒值。

它也允许格式化和解析日期字符串。不过，这些函数的 API 不易于实现国际化。从 JDK 1.1 开始，应

该使用 Calendar 类实现日期和时间字段之间转换，使用 DateFormat 类来格式化和解析日期字符串。

Date 中的相应方法已废弃。

Date()

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

Date(long date)

　　分配 Date 对象并初始化此对象，以表示自从标准基准时间（称为“历元（epoch）”，即

　　1970 年 1 月 1 日 00:00:00 GMT）以来的指定毫秒数。

boolean after(Date when)
          测试此日期是否在指定日期之后。

boolean before(Date when)
          测试此日期是否在指定日期之前。

Objectclone()
          返回此对象的副本。

int compareTo(Date anotherDate)
          比较两个日期的顺序。

boolean equals(Object obj)
          比较两个日期的相等性。

类 Calendar

Calendar 类是一个抽象类，它为特定瞬间与一组诸如 YEAR、MONTH、DAY_OF_MONTH、HOUR 等

日历字段之间的转换提供了一些方法，并为操作日历字段（例如获得下星期的日期）提供了一

些方法。瞬间可用毫秒值来表示，它是距历元（即格林威治标准时间 1970 年 1 月 1 日的

00:00:00.000，格里高利历）的偏移量。

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

abstract  void add(int field, int amount) 
          根据日历的规则，为给定的日历字段添加或减去指定的时间量。 
 void clear() 
          将此 Calendar 的所日历字段值和时间值（从历元至现在的毫秒偏移量）设置成未定义。 
protected abstract  void computeTime() 
          将 fields[] 中的当前日历字段值转换为毫秒时间值 time。 
 boolean equals(Object obj) 
          将此 Calendar 与指定 Object 比较。 
 String getDisplayName(int field, int style, Locale locale) 
          返回给定 style 和 locale 下的日历 field 值的字符串表示形式。 
static Calendar getInstance() 
          使用默认时区和语言环境获得一个日历。 
static Calendar getInstance(Locale aLocale) 
          使用默认时区和指定语言环境获得一个日历。 
static Calendar getInstance(TimeZone zone) 
          使用指定时区和默认语言环境获得一个日历。 
static Calendar getInstance(TimeZone zone, Locale aLocale) 
          使用指定时区和语言环境获得一个日历。 
 Date getTime() 
          返回一个表示此 Calendar 时间值（从历元至现在的毫秒偏移量）的 Date 对象。 
 long getTimeInMillis() 
          返回此 Calendar 的时间值，以毫秒为单位。 

 void set(int field, int value) 
          将给定的日历字段设置为给定值。 
 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 setTime(Date date) 
          使用给定的 Date 设置此 Calendar 的时间。 
 void setTimeInMillis(long millis) 
          用给定的 long 值设置此 Calendar 的当前时间值。 
 void setTimeZone(TimeZone value) 
          使用给定的时区值来设置时区。 

 

类 DateFormat

DateFormat 是日期/时间格式化子类的抽象类，它以与语言无关的方式格式化并解析日期或时间。

日期/时间格式化子类（如 SimpleDateFormat）允许进行格式化（也就是日期 -> 文本）、

解析（文本-> 日期）和标准化。

DateFormat()
          创建一个新的 DateFormat。

String format(Date date) 
          将一个 Date 格式化为日期字符串。 
abstract  StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition) 
          将一个 Date 格式化为日期字符串。 
Calendar getCalendar() 
          获取与此日期格式器关联的日历。 
static DateFormat getDateInstance() 
          获取日期格式器，该格式器具有默认语言环境的默认格式化风格。 
static DateFormat getInstance() 
          获取为日期和时间使用 SHORT 风格的默认日期格式器。 
 NumberFormat getNumberFormat() 
          获取此日期格式器用于格式化和解析时间的数字格式器。 
static DateFormat getTimeInstance() 
          获取时间格式器，该格式器具有默认语言环境的默认格式化风格。 
Date parse(String source) 
          从给定字符串的开始解析文本，以生成一个日期。 
abstract  Date parse(String source, ParsePosition pos) 
          根据给定的解析位置开始解析日期字符串。 
Object parseObject(String source, ParsePosition pos) 
          解析字符串中的文本，以生成一个 Date。 
void setCalendar(Calendar newCalendar) 
          设置此日期格式所使用的日历。

类 SimpleDateFormat

SimpleDateFormat 是一个以与语言环境有关的方式来格式化和解析日期的具体类。

它允许进行格式化（日期 -> 文本）、解析（文本 -> 日期）和规范化。

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

  void applyLocalizedPattern(String pattern) 
          将给定的本地化模式字符串应用于此日期格式。 
 StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition pos) 
          将给定的 Date 格式化为日期字符串，并将结果添加到给定的 StringBuffer。 
 AttributedCharacterIterator formatToCharacterIterator(Object obj) 
          格式化生成 AttributedCharacterIterator 的对象。 
 Date parse(String text, ParsePosition pos) 
          解析字符串的文本，生成 Date。 
 void setDateFormatSymbols(DateFormatSymbols newFormatSymbols) 
          设置此日期格式的日期和时间格式符号。 
 String toLocalizedPattern() 
          返回描述此日期格式的本地化模式字符串。 
 String toPattern() 
          返回描述此日期格式的模式字符串。 

类 Timer

一种工具，线程用其安排以后在后台线程中执行的任务。可安排任务执行一次，或者定期重复执行。

Timer()
　　创建一个新计时器。
Timer(boolean isDaemon)
　　创建一个新计时器，可以指定其相关的线程作为守护程序运行。
Timer(String name)
　　创建一个新计时器，其相关的线程具有指定的名称。
Timer(String name, boolean isDaemon)
　　创建一个新计时器，其相关的线程具有指定的名称，并且可以指定作为守护程序运行。

void cancel()
　　终止此计时器，丢弃所有当前已安排的任务。
int purge()
　　从此计时器的任务队列中移除所有已取消的任务。
void schedule(TimerTask task, Date time)
　　安排在指定的时间执行指定的任务。
void schedule(TimerTask task, Date firstTime, long period)
　　安排指定的任务在指定的时间开始进行重复的固定延迟执行。
void schedule(TimerTask task, long delay)
　　安排在指定延迟后执行指定的任务。
void schedule(TimerTask task, long delay, long period)
　　安排指定的任务从指定的延迟后开始进行重复的固定延迟执行。
void scheduleAtFixedRate(TimerTask task, Date firstTime, long period)
　　安排指定的任务在指定的时间开始进行重复的固定速率执行。
void scheduleAtFixedRate(TimerTask task, long delay, long period)
　　安排指定的任务在指定的延迟后开始进行重复的固定速率执行。

类 TimerTask

TimerTask()
          创建一个新的计时器任务。

boolean cancel()
　　取消此计时器任务。
abstract void run()
　　此计时器任务要执行的操作。
long scheduledExecutionTime()
　　返回此任务最近实际 执行的已安排 执行时间。