# Java 日期时间 java.util包提供了Date类来封装当前的日期和时间。 Date类提供两个构造函数来实例化Date对象。 第一个构造函数使用当前日期和时间来初始化对象。 ``` Date( ) ``` 第二个构造函数接收一个参数，该参数是从1970年1月1日起的微秒数。 ``` Date(long millisec) ``` Date对象创建以后，可以调用下面的方法。 | 方法 | 描述 | | --- | --- | | **boolean after(Date date)** | 若当调用此方法的Date对象在指定日期之后返回true,否则返回false。 | | **boolean before(Date date)** | 若当调用此方法的Date对象在指定日期之前返回true,否则返回false。 | | **Object clone( )** | 返回此对象的副本。 | | **int compareTo(Date date)** | 比较当调用此方法的Date对象和指定日期。两者相等时候返回0。调用对象在指定日期之前则返回负数。调用对象在指定日期之后则返回正数。 | | **int compareTo(Object obj)** | 若obj是Date类型则操作等同于compareTo(Date) 。否则它抛出ClassCastException。 | | **boolean equals(Object date)** | 当调用此方法的Date对象和指定日期相等时候返回true,否则返回false。 | | **long getTime( )** | 返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此 Date 对象表示的毫秒数。 | | **int hashCode( )** |  返回此对象的哈希码值。 | | **void setTime(long time)** | 用自1970年1月1日00:00:00 GMT以后time毫秒数设置时间和日期。 | | **String toString( )** | 转换Date对象为String表示形式，并返回该字符串。 | ## 获取当前日期时间 Java中获取当前日期和时间很简单，使用Date对象的 toString()方法来打印当前日期和时间，如下所示： ``` import java.util.Date; public class DateDemo { public static void main(String args[]) { // 初始化 Date 对象 Date date = new Date(); // 使用 toString() 函数显示日期时间 System.out.println(date.toString()); } } ``` 以上实例编译运行结果如下: ``` Mon May 04 09:51:52 CDT 2013 ``` ## 日期比较 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类实现了这个接口。 ## 使用SimpleDateFormat格式化日期 SimpleDateFormat是一个以语言环境敏感的方式来格式化和分析日期的类。SimpleDateFormat允许你选择任何用户自定义日期时间格式来运行。例如： ``` import java.util.*; import java.text.*; public class DateDemo { public static void main(String args[]) { Date dNow = new Date( ); SimpleDateFormat ft = new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz"); System.out.println("Current Date: " + ft.format(dNow)); } } ``` 以上实例编译运行结果如下: ``` Current Date: Sun 2004.07.18 at 04:14:09 PM PDT ``` ## 简单的DateFormat格式化编码 时间模式字符串用来指定时间格式。在此模式中，所有的ASCII字母被保留为模式字母，定义如下： | **字母** | **描述** | **示例** | | --- | --- | --- | | G | 纪元标记 | AD | | y | 四位年份 | 2001 | | M | 月份 | July or 07 | | d | 一个月的日期 | 10 | | h |  A.M./P.M. (1~12)格式小时 | 12 | | H | 一天中的小时 (0~23) | 22 | | m | 分钟数 | 30 | | s | 秒数 | 55 | | S | 微妙数 | 234 | | E | 星期几 | Tuesday | | D | 一年中的日子 | 360 | | F | 一个月中第几周的周几 | 2 (second Wed. in July) | | w | 一年中第几周 | 40 | | W | 一个月中第几周 | 1 | | a | A.M./P.M. 标记 | PM | | k | 一天中的小时(1~24) | 24 | | K |  A.M./P.M. (0~11)格式小时 | 10 | | z | 时区 | Eastern Standard Time | | ' | 文字定界符 | Delimiter | | " | 单引号 | ` | ## 使用printf格式化日期 printf方法可以很轻松地格式化时间和日期。使用两个字母格式，它以t开头并且以下面表格中的一个字母结尾。例如： ``` import java.util.Date; public class DateDemo { public static void main(String args[]) { // 初始化 Date 对象 Date date = new Date(); // 使用toString()显示日期和时间 String str = String.format("Current Date/Time : %tc", date ); System.out.printf(str); } } ``` 以上实例编译运行结果如下: ``` Current Date/Time : Sat Dec 15 16:37:57 MST 2012 ``` 如果你需要重复提供日期，那么利用这种方式来格式化它的每一部分就有点复杂了。因此，可以利用一个格式化字符串指出要被格式化的参数的索引。 索引必须紧跟在%后面，而且必须以$结束。例如： ``` import java.util.Date; public class DateDemo { public static void main(String args[]) { // 初始化 Date 对象 Date date = new Date(); // 使用toString()显示日期和时间 System.out.printf("%1$s %2$tB %2$td, %2$tY", "Due date:", date); } } ``` 以上实例编译运行结果如下: ``` Due date: February 09, 2004 ``` 或者，你可以使用<标志。它表明先前被格式化的参数要被再次使用。例如： ``` import java.util.Date; public class DateDemo { public static void main(String args[]) { // 初始化 Date 对象 Date date = new Date(); // 显示格式化时间 System.out.printf("%s %tB %c1.add(Calendar.DATE, -10); ``` 其他字段属性的add的意义以此类推 ### Calendar类对象信息的获得 ``` 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); ``` ## GregorianCalendar类 Calendar类实现了公历日历，GregorianCalendar是Calendar类的一个具体实现。 Calendar 的getInstance（）方法返回一个默认用当前的语言环境和时区初始化的GregorianCalendar对象。GregorianCalendar定义了两个字段：AD和BC。这些代表公历定义的两个时代。 下面列出GregorianCalendar对象的几个构造方法： | **构造函数** | **说明** | | --- | --- | | **GregorianCalendar()** | 在具有默认语言环境的默认时区内使用当前时间构造一个默认的 GregorianCalendar。 | | **GregorianCalendar(int year, int month, int date)** | 在具有默认语言环境的默认时区内构造一个带有给定日期设置的 GregorianCalendar | | **GregorianCalendar(int year, int month, int date, int hour, int minute)** | 为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。 | | **GregorianCalendar(int year, int month, int date, int hour, int minute, int second)** |   为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。 | | **GregorianCalendar(Locale aLocale)** | 在具有给定语言环境的默认时区内构造一个基于当前时间的 GregorianCalendar。 | | **GregorianCalendar(TimeZone zone)** | 在具有默认语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。 | | **GregorianCalendar(TimeZone zone, Locale aLocale)** |  在具有给定语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。 | 这里是GregorianCalendar 类提供的一些有用的方法列表： | **方法** | **说明** | | --- | --- | | **void add(int field, int amount)** | 根据日历规则，将指定的（有符号的）时间量添加到给定的日历字段中。 | | **protected void computeFields()** | 转换UTC毫秒值为时间域值 | | **protected void computeTime()** | 覆盖Calendar ，转换时间域值为UTC毫秒值 | | **boolean equals(Object obj)** | 比较此 GregorianCalendar 与指定的 Object。 | | **int get(int field)** | 获取指定字段的时间值 | | **int getActualMaximum(int field)** | 返回当前日期，给定字段的最大值 | | **int getActualMinimum(int field)** | 返回当前日期，给定字段的最小值 | | **int getGreatestMinimum(int field)** |  返回此 GregorianCalendar 实例给定日历字段的最高的最小值。 | | **Date getGregorianChange()** | 获得格里高利历的更改日期。 | | **int getLeastMaximum(int field)** | 返回此 GregorianCalendar 实例给定日历字段的最低的最大值 | | **int getMaximum(int field)** | 返回此 GregorianCalendar 实例的给定日历字段的最大值。 | | **Date getTime()** | 获取日历当前时间。 | | **long getTimeInMillis()** | 获取用长整型表示的日历的当前时间 | | **TimeZone getTimeZone()** | 获取时区。 | | **int getMinimum(int field)** | 返回给定字段的最小值。 | | **int hashCode()** | 重写hashCode. | | **boolean isLeapYear(int year)** | 确定给定的年份是否为闰年。 | | **void roll(int field, boolean up)** | 在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。 | | **void set(int field, int value)** | 用给定的值设置时间字段。 | | **void set(int year, int month, int date)** | 设置年、月、日的值。 | | **void set(int year, int month, int date, int hour, int minute)** | 设置年、月、日、小时、分钟的值。 | | **void set(int year, int month, int date, int hour, int minute, int second)** | 设置年、月、日、小时、分钟、秒的值。 | | **void setGregorianChange(Date date)** | 设置 GregorianCalendar 的更改日期。 | | **void setTime(Date date)** | 用给定的日期设置Calendar的当前时间。 | | **void setTimeInMillis(long millis)** | 用给定的long型毫秒数设置Calendar的当前时间。 | | **void setTimeZone(TimeZone value)** | 用给定时区值设置当前时区。 | | **String toString()** | 返回代表日历的字符串。 | ### 实例 ``` import java.util.*; public class GregorianCalendarDemo { public static void main(String args[]) { 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) + ":"); 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: Apr 22 2009 Time: 11:25:27 当前年份不是闰年 ``` 关于Calender 类的完整列表，你可以参考标准的Java文档。