[java tutorial] Java date and time

Java date and time

java.util package provides the Date class to encapsulate the current date and time. The Date class provides two constructors to instantiate Date objects.

The first constructor initializes the object using the current date and time.

Date( )

The second constructor receives a parameter, which is the number of microseconds since January 1, 1970. After the

Date(long millisec)

Date object is created, you can call the following method.

Serial number

Method and description

1 boolean after(Date date)
If the Date object that calls this method is after the specified date, it returns true, otherwise it returns false.

2 boolean before(Date date)
If the Date object calling this method returns true before the specified date, otherwise it returns false.

3 Object clone()
Returns a copy of this object.

4 int compareTo(Date date)
Compares the Date object when this method is called with the specified date. When the two are equal, 0 is returned. If the calling object is before the specified date, a negative number is returned. The calling object returns a positive number after the specified date.

5 int compareTo(Object obj)
If obj is Date type, the operation is equivalent to compareTo(Date). Otherwise it throws ClassCastException.

6 boolean equals(Object date)
Returns true when the Date object calling this method is equal to the specified date, otherwise returns false.

7 long getTime( )
Returns the number of milliseconds represented by this Date object since January 1, 1970 00:00:00 GMT.

8 int hashCode()
Returns the hash code value of this object.

9 void setTime(long time)

Set the time and date using the number of milliseconds since January 1, 1970 00:00:00 GMT.

10 String toString()
Convert the Date object to String representation and return the string.

Getting the current date and time

Getting the current date and time in Java is very simple. Use the toString() method of the Date object to print the current date and time, as shown below:

import java.util.Date;
  
public class DateDemo {
   public static void main(String args[]) {
       // 初始化 Date 对象
       Date date = new Date();
        
       // 使用 toString() 函数显示日期时间
       System.out.println(date.toString());
   }
}

The above example compilation and running results are as follows:

Mon May 04 09:51:52 CDT 2013

Date comparison

Java uses the following three methods to compare two dates:

Use the getTime() method to obtain two dates date (numeric value elapsed since January 1, 1970) and then compare the two values.

Use the methods before(), after() and equals(). For example, if the 12th of a month is earlier than the 18th, then new Date(99, 2, 12).before(new Date (99, 2, 18)) returns true.

Use the compareTo() method, which is defined by the Comparable interface, and the Date class implements this interface.

Format dates using SimpleDateFormat

SimpleDateFormat is a class for formatting and parsing dates in a locale-sensitive manner. SimpleDateFormat allows you to choose any user-defined date and time format to run on. For example:

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));
   }
}

The above example compilation and running results are as follows:

Current Date: Sun 2004.07.18 at 04:14:09 PM PDT

Simple DateFormat format encoding

Time pattern string is used to specify the time format . In this mode, all ASCII letters are reserved as pattern letters, defined as follows:

letters

description

example

G Epoch mark AD

y Four-digit year 2001

M Month July or 07

d Date of the month 10

h A.M./P.M. (1~12) format hour 12

H Hour of the day (0~23) 22

m Minutes 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 class="brush:php;toolbar:false">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对象的几个构造方法：

序号 构造函数和说明

1 GregorianCalendar()
在具有默认语言环境的默认时区内使用当前时间构造一个默认的 GregorianCalendar。

2 GregorianCalendar(int year, int month, int date)
在具有默认语言环境的默认时区内构造一个带有给定日期设置的 GregorianCalendar

3 GregorianCalendar(int year, int month, int date, int hour, int minute)
为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。

4 GregorianCalendar(int year, int month, int date, int hour, int minute, int second)
为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。

5 GregorianCalendar(Locale aLocale)
在具有给定语言环境的默认时区内构造一个基于当前时间的 GregorianCalendar。

6 GregorianCalendar(TimeZone zone)
在具有默认语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。

7 GregorianCalendar(TimeZone zone, Locale aLocale)
在具有给定语言环境的给定时区内构造一个基于当前时间的 GregorianCalendar。

这里是GregorianCalendar 类提供的一些有用的方法列表：

序号 方法和说明

1 void add(int field, int amount)
根据日历规则，将指定的（有符号的）时间量添加到给定的日历字段中。

2 protected void computeFields()
转换UTC毫秒值为时间域值

3 protected void computeTime()
覆盖Calendar ，转换时间域值为UTC毫秒值

4 boolean equals(Object obj)
比较此 GregorianCalendar 与指定的 Object。

5 int get(int field)
获取指定字段的时间值

6 int getActualMaximum(int field)
返回当前日期，给定字段的最大值

7 int getActualMinimum(int field)
返回当前日期，给定字段的最小值

8 int getGreatestMinimum(int field)
返回此 GregorianCalendar 实例给定日历字段的最高的最小值。

9 Date getGregorianChange()
获得格里高利历的更改日期。

10 int getLeastMaximum(int field)
返回此 GregorianCalendar 实例给定日历字段的最低的最大值

11 int getMaximum(int field)
返回此 GregorianCalendar 实例的给定日历字段的最大值。

12 Date getTime()
获取日历当前时间。

13 long getTimeInMillis()
获取用长整型表示的日历的当前时间

14 TimeZone getTimeZone()
获取时区。

15 int getMinimum(int field)
返回给定字段的最小值。

16 int hashCode()
重写hashCode.

17 boolean isLeapYear(int year)
确定给定的年份是否为闰年。

18 void roll(int field, boolean up)
在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。

19 void set(int field, int value)
用给定的值设置时间字段。

20 void set(int year, int month, int date)
设置年、月、日的值。

21 void set(int year, int month, int date, int hour, int minute)
设置年、月、日、小时、分钟的值。

22 void set(int year, int month, int date, int hour, int minute, int second)
设置年、月、日、小时、分钟、秒的值。

23 void setGregorianChange(Date date)
设置 GregorianCalendar 的更改日期。

24 void setTime(Date date)
用给定的日期设置Calendar的当前时间。

25 void setTimeInMillis(long millis)
用给定的long型毫秒数设置Calendar的当前时间。

26 void setTimeZone(TimeZone value)
用给定时区值设置当前时区。

27 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 日期时间的内容，更多相关内容请关注PHP中文网（www.php.cn）！