# 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 %<te, %<tY",
"Due date:", date);
}
}
```
以上实例编译运行结果如下:
```
Due date: February 09, 2004
```
## 日期和时间转换字符
| **字符** | **描述** | **例子** |
| --- | --- | --- |
| c | 完整的日期和时间 | Mon May 04 09:51:52 CDT 2009 |
| F | ISO 8601 格式日期 | 2004-02-09 |
| D | U.S. 格式日期 (月/日/年) | 02/09/2004 |
| T | 24小时时间 | 18:05:19 |
| r | 12小时时间 | 06:05:19 pm |
| R | 24小时时间，不包含秒 | 18:05 |
| Y | 4位年份(包含前导0) | 2004 |
| y | 年份后2位(包含前导0) | 04 |
| C | 年份前2位(包含前导0) | 20 |
| B | 月份全称 | February |
| b | 月份简称 | Feb |
| n | 2位月份(包含前导0) | 02 |
| d | 2位日子(包含前导0) | 03 |
| e | 2位日子(不包含前导0) | 9 |
| A | 星期全称 | Monday |
| a | 星期简称 | Mon |
| j | 3位年份(包含前导0) | 069 |
| H | 2位小时(包含前导0), 00 到 23 | 18 |
| k | 2位小时(不包含前导0), 0 到 23 | 18 |
| I | 2位小时(包含前导0), 01 到 12 | 06 |
| l | 2位小时(不包含前导0), 1 到 12 | 6 |
| M | 2位分钟(包含前导0) | 05 |
| S | 2位秒数(包含前导0) | 19 |
| L | 3位毫秒(包含前导0) | 047 |
| N | 9位纳秒(包含前导0) | 047000000 |
| P | 大写上下午标志 | PM |
| p | 小写上下午标志 | pm |
| z | 从GMT的RFC 822数字偏移 | -0800 |
| Z | 时区 | PST |
| s | 自 1970-01-01 00:00:00 GMT的秒数 | 1078884319 |
| Q | 自 1970-01-01 00:00:00 GMT的毫妙 | 1078884319047 |
还有其他有用的日期和时间相关的类。对于更多的细节，你可以参考到Java标准文档。
## 解析字符串为时间
SimpleDateFormat 类有一些附加的方法，特别是parse()，它试图按照给定的SimpleDateFormat 对象的格式化存储来解析字符串。例如：
```
import java.util.*;
import java.text.*;
public class DateDemo {
public static void main(String args[]) {
SimpleDateFormat ft = new SimpleDateFormat ("yyyy-MM-dd");
String input = args.length == 0 ? "1818-11-11" : args[0];
System.out.print(input + " Parses as ");
Date t;
try {
t = ft.parse(input);
System.out.println(t);
} catch (ParseException e) {
System.out.println("Unparseable using " + ft);
}
}
}
```
以上实例编译运行结果如下:
```
$ java DateDemo
1818-11-11 Parses as Wed Nov 11 00:00:00 GMT 1818
$ java DateDemo 2007-12-01
2007-12-01 Parses as Sat Dec 01 00:00:00 GMT 2007
```
Java 休眠(sleep)
你可以让程序休眠一毫秒的时间或者到您的计算机的寿命长的任意段时间。例如，下面的程序会休眠10秒：
```
import java.util.*;
public class SleepDemo {
public static void main(String args[]) {
try {
System.out.println(new Date( ) + "\n");
Thread.sleep(5*60*10);
System.out.println(new Date( ) + "\n");
} catch (Exception e) {
System.out.println("Got an exception!");
}
}
}
```
以上实例编译运行结果如下:
```
Sun May 03 18:04:41 GMT 2009
Sun May 03 18:04:51 GMT 2009
```
## 测量时间
下面的一个例子表明如何测量时间间隔（以毫秒为单位）：
```
import java.util.*;
public class DiffDemo {
public static void main(String args[]) {
try {
long start = System.currentTimeMillis( );
System.out.println(new Date( ) + "\n");
Thread.sleep(5*60*10);
System.out.println(new Date( ) + "\n");
long end = System.currentTimeMillis( );
long diff = end - start;
System.out.println("Difference is : " + diff);
} catch (Exception e) {
System.out.println("Got an exception!");
}
}
}
```
以上实例编译运行结果如下:
```
Sun May 03 18:16:51 GMT 2009
Sun May 03 18:16:57 GMT 2009
Difference is : 5993
```
## Calendar类
我们现在已经能够格式化并创建一个日期对象了，但是我们如何才能设置和获取日期数据的特定部分呢，比如说小时，日，或者分钟? 我们又如何在日期的这些部分加上或者减去值呢? 答案是使用Calendar 类。
Calendar类的功能要比Date类强大很多，而且在实现方式上也比Date类要复杂一些。
Calendar类是一个抽象类，在实际使用时实现特定的子类的对象，创建对象的过程对程序员来说是透明的，只需要使用getInstance方法创建即可。
### 创建一个代表系统当前日期的Calendar对象
```
Calendar c = Calendar.getInstance();//默认是当前日期
```
### 创建一个指定日期的Calendar对象
使用Calendar类代表特定的时间，需要首先创建一个Calendar的对象，然后再设定该对象中的年月日参数来完成。
```
//创建一个代表2009年6月12日的Calendar对象
Calendar c1 = Calendar.getInstance();
c1.set(2009, 6 - 1, 12);
```
### Calendar类对象字段类型
Calendar类中用一下这些常量表示不同的意义，jdk内的很多类其实都是采用的这种思想
| 常量 | 描述 |
| --- | --- |
| Calendar.YEAR | 年份 |
| Calendar.MONTH | 月份 |
| Calendar.DATE | 日期 |
| Calendar.DAY_OF_MONTH | 日期，和上面的字段意义完全相同 |
| Calendar.HOUR | 12小时制的小时 |
| Calendar.HOUR_OF_DAY | 24小时制的小时 |
| Calendar.MINUTE | 分钟 |
| Calendar.SECOND | 秒 |
| Calendar.DAY_OF_WEEK | 星期几 |
### Calendar类对象信息的设置
**Set设置**
如：
```
Calendar c1 = Calendar.getInstance();
```
调用：
```
public final void set(int year,int month,int date)
```
```
c1.set(2009, 6 - 1, 12);//把Calendar对象c1的年月日分别设这为：2009、6、12
```
利用字段类型设置
如果只设定某个字段，例如日期的值，则可以使用如下set方法：
```
public void set(int field,int value)
```
把 c1对象代表的日期设置为10号，其它所有的数值会被重新计算
```
c1.set(Calendar.DATE,10);
```
把c1对象代表的年份设置为2008年，其他的所有数值会被重新计算
```
c1.set(Calendar.YEAR,2008);
```
其他字段属性set的意义以此类推
**Add设置**
```
Calendar c1 = Calendar.getInstance();
```
把c1对象的日期加上10，也就是c1所表的日期的10天后的日期，其它所有的数值会被重新计算
```
c1.add(Calendar.DATE, 10);
```
把c1对象的日期加上10，也就是c1所表的日期的10天前的日期，其它所有的数值会被重新计算
```
<pre>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文档。
- Java 基础
- Java 简介
- Java开发环境配置
- Java基础语法
- Java对象和类
- Java基本数据类型
- Java变量类型
- Java修饰符
- Java运算符
- Java循环结构 - for, while 及 do...while
- Java分支结构 - if...else/switch
- Java Number类
- Java Character类
- Java String类
- Java StringBuffer和StringBuilder类
- Java 数组
- Java 日期时间
- Java正则表达式
- Java 方法
- Java 流(Stream)、文件(File)和IO
- Java 异常处理
- Java 面向对象
- Java 继承
- Java 重写(Override)与重载(Overload)
- Java 多态
- Java 抽象类
- Java 接口
- Java 包(package)
- Java 高级教程
- Java 数据结构
- Java Enumeration接口
- Java Bitset类
- Java Vector 类
- Java Stack 类
- Java Dictionary 类
- Java Hashtable 接口
- Java Properties 接口
- Java 集合框架
- Java 泛型
- Java序列化
- Java 网络编程
- Java 发送邮件
- Java 多线程编程
- Java Applet基础
- Java 文档注释
- Servlet 教程
- Servlet 简介
- Servlet 环境设置
- Servlet 生命周期
- Servlet 实例
- Servlet 表单数据
- Servlet 客户端 HTTP 请求
- Servlet 服务器 HTTP 响应
- Servlet HTTP 状态码
- Servlet 编写过滤器
- Servlet 异常处理
- Servlet Cookies 处理
- Servlet Session 跟踪
- Servlet 数据库访问
- Servlet 文件上传
- Servlet 处理日期
- Servlet 网页重定向
- Servlet 点击计数器
- Servlet 自动刷新页面
- Servlet 发送电子邮件
- Servlet 包
- Servlet 调试
- Servlet 国际化
- JSP 基础
- JSP 简介
- JSP 开发环境搭建
- JSP 结构
- JSP 生命周期
- JSP 语法
- JSP 指令
- JSP 动作元素
- JSP 动作元素
- JSP 隐含对象
- JSP 客户端请求
- JSP 服务器响应
- JSP HTTP 状态码
- JSP 表单处理
- JSP 过滤器
- JSP Cookies 处理
- JSP Session
- JSP 文件上传
- JSP 日期处理
- JSP 页面重定向
- JSP 点击量统计
- JSP 自动刷新
- JSP 发送邮件
- JSP 高级教程
- JSP 标准标签库（JSTL）
- JSP 连接数据库
- JSP XML 数据处理
- JSP JavaBean
- JSP 自定义标签
- JSP 表达式语言
- JSP 异常处理
- JSP 调试
- JSP 国际化
- 免责声明