java.util工具类之Date、Calendar、GregorianCalendar、TimeZone、SimpleTimeZone、Locale

JDK8在线Api中文手册java

JDK8在线Api英文手册
web

Date 类

   Date类封装了当前日期和时间。与Java1.0定义的原始版Date类相比，Date类发生了本质性的变化。在Java1.1发布时，原始版Date类定义的许多功能被移进Calendar和DateFormat类类中。所以，Java1.0中原始版Date类中的许多方法已经不同意使用。对于新代码，不该当使用已不同意使用的Java1.0版方法，在此不介绍这些方法。
   Date类支持如下构造函数：api

Date()
Date(long millisec)

   第1个构造函数使用当前日期和时间初始化对象。第2个构造函数接受一个参数，该参数等于自1970年1月1日午夜以来经历的毫秒数。表1显示了Date类定义的那些仍然同意使用的方法。Date类还实现了Comparable接口。数组

   经过检查表1能够看出，仍然同意使用的Date特性不容许获取日期或时间的单个组成部分。正以下面的程序锁演示的，只能以毫秒为单位获取日期和时间，或者经过toString()方法返回日期和时间的默认字符串表示形式，或者(从JDK8开始)做为Instant对象来获取日期和时间，为了获取关于日期和时间的更详细信息，须要使用Calendar类。oracle

//Show date and time using only Date methods.
import java.util.Date;
class DateDemo {
    public static void main(String[] args) {
        //Instantiate a Date object
        Date date = new Date();
        //display time and date using toString()
        System.out.println(date);
        //Display number of milliseconds since midnight,January 1,1970 GMT
        long msec = date.getTime();
        System.out.println("Milliseconds since Jan. 1,1970 GMT = "+msec);
        /** * 输出： * Sat Feb 08 15:23:47 CST 2020 * Milliseconds since Jan. 1,1970 GMT = 1581146627936 */
    }
}

Calendar 类

   Calendar抽象类提供了一套方法，容许将毫秒形式的时间转换成大量有用的时间组成部分，能够提供的这类信息的一些例子有年、月、日、小时、分和秒。Calendar的子类将提供根据它们本身的规则解释时间信息的功能。这是Java类库使咱们可以编写在国际化环境中运行的程序的一个方面。这种子类的一个GregorainCalendar。
   注意
   JDK8在java.time中定义了新的日期和时间API。
   Calendar类没有提供公有的构造函数。Calendar类定义了几个受保护的实例变量。areFieldsSet是布尔型变量，指示是否设置了时间组成部分。fields是int型数组，用来保存时间组成部分。isSet是布尔型数组，指示是否设置了特定的时间组成部分。time是长整型变量，用来保存这个对象的当前时间。isTimeSet是布尔型变量，指示了是否设置了当前时间。svg

   Calendar类定义了如下int型常量，当获取或设置日历的组成部分时，须要用到这些常量，带有FOTMAT和STANDALONE后缀的都是JDK8新增的常量：函数

   下面的程序演示了Calendar类的一些方法：工具

//Demonstrate Calendar
import java.util.Calendar;
class CalendarDemo {
public static void main(String[] args) {
      String months[]={
              "Jan","Feb","Mar","Apr",
              "May","Jun","Jul","Aug",
              "Sep","Oct","Nov","Dec"
      };
      //Create a calendar initialized with the
      //current date and time int the default
      //locale and timezone.
      Calendar calendar = Calendar.getInstance();
      //Display current and date information.
      System.out.print("Date: ");
      System.out.print(months[calendar.get(Calendar.MONTH)]);
      System.out.print(" "+calendar.get(Calendar.DATE)+" ");
      System.out.println(calendar.get(Calendar.YEAR));
      System.out.print("Time: ");
      System.out.print(calendar.get(Calendar.HOUR)+":");
      System.out.print(calendar.get(Calendar.MINUTE)+":");
      System.out.println(calendar.get(Calendar.SECOND));
      //Set the time and date information and display it.
      calendar.set(Calendar.HOUR,20);
      calendar.set(Calendar.MINUTE,20);
      calendar.set(calendar.SECOND,20);
      System.out.print("Updated time: ");
      System.out.print(calendar.get(Calendar.HOUR)+":");
      System.out.print(calendar.get(Calendar.MINUTE)+":");
      System.out.println(calendar.get(Calendar.SECOND));
      /** * 输出： * Date: Feb 8 2020 * Time: 4:47:17 * Updated time: 8:20:20 */
  }
}

GregorianCalendar 类

   GregorainCalendar类是Calendar类的具体实现，实现了Gregorain日历。Calendar类的getInstance()方法一般会返回一个GregorainCalendar对象，这个对象使用默认地区和时区下的当前日期和时间进行初始化。
   GregorainCalendar定义了两个域变量：AD和BC。它们表示格林尼治日历定义的两个纪元。
   GregorainCalendar对象还有几个构造函数。默认构造函数GregorainCalendar()使用默认地区和时区下的当前日期和时间进行初始化。还有如下3个构造函数能够指定其余信息：测试

GregorainCalendar(int year,int month,int dayOfMonth)
GregorainCalendar(int year,int month,int dayOfMonth,int hours,int minutes)
GregorainCalendar(int year,int month,int dayOfMonth,int hours,int minutes,int seconds)

   全部这3个版本都设置年、月和日。其中,year指定了年。月是由month指定的，0表示1月。月份中的日期是由dayofMonth指定的。第1个版本中奖时间设置为午夜，第2个版本中还设置了小时和分钟，第3个版本添加了秒。
   能够经过指定地区和/或时区来构造GregorainCalendar对象。使用以下构造函数建立的对象，将使用指定时区和/或地区下的当前时间进行初始化：ui

GregorainCalendar(Locale locale)
GregorainCalendar(TimeZone timeZone)
GregorainCalendar(TimeZone timeZone,Locale locale)

   GregorainCalendar实现了Calendar中的全部抽象方法，另外还提供了一些附加方法，如isLeapYear(),该方法测试某年是不是闰年，形式以下：

boolean isLeapYear(int year)

   若是year是闰年，该方法就返回true;不然返回false。JDK8还添加了如下方法：fro()和toZoneDateTime(),用于支持新的日期和时间API;getCalendarType(),它将日历类型做为一个字符串返回，即"gregory"。
   下面的程序演示了GregorainCalendar类：

//Demonstrate GregorianCalendar类：
import java.util.Calendar;
import java.util.GregorianCalendar;
class GregorianCalendarDemo {
 public static void main(String[] args) {
      String months[]={
              "Jan","Feb","Mar","Apr",
              "May","Jun","Jul","Aug",
              "Sep","Oct","Nov","Dec"
      };
      int year;
      //Create a Gregorian calendar initialized
      //with the current date and time in the
      //default locale and timezone.
      GregorianCalendar gcalendar = new GregorianCalendar();
      //Display current time anf date information.
      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));
      //Test if the current year is a leap year
      if(gcalendar.isLeapYear(year)){
          System.out.println("The current year is a leap year");
      }else{
          System.out.println("The current year is not a leap year");
      }
      /** * 输出： * Date: Feb 8 2020 * Time: 5:23:12 * The current year is a leap year */
  }
}

TimeZone 类

   另一个与时间相关的类是TimeZone。TimeZone抽象类能够处理与格林尼治标准时间(Greenwich Mean Time,GMT)——也就是世界时间(Universal Time Coordinated,UTC)之间的时差。另外还可以计算夏令时。TimeZone只支持一个默认构造函数。

SimpleTimeZone 类

   SimpleTimeZone类是TimeZone的一个便利子类。它实现了TimeZone的抽象方法，而且能够操做Gregorian日历的时区，此外还可以计算夏令时。
   SimpleTimeZone类定义了4个构造函数，其中一个以下：

SimpleTimeZone(int timeDelta,String tzName)

   这个构造函数建立一个SimpleTimeZone对象，这个对象相对于格林尼治标准时间(GMT)的时差是timeDelta,时区名称为tzName。
   第2个SimpleTimeZone构造函数以下：

SimpleTimeZone(int timeDelta,String tzId,int dstMonth0,int dstDayInMonth0,int dstDay0,int time0,int dstMonth1,int dstDayInMonth1,int dstDay1,int time1)

   其中，相对于GMT的时差是由timeDelta指定的。时区名称是由tzID传入的。夏令时的开始时间是由参数dstMonth0,dstDayInMonth0,dstDay0和time0指定的。夏令时的结束时间是由参数dstMonth一、dstDayInMonth一、dstDay1和time1指定的。
   第3个SimpleTimeZone构造函数以下：

SimpleTimeZone(int timeDelta,String tzId,int dstMonth0,int dstDayInMonth0,int dstDay0,int time0,int dstMonth1,int dstDayInMonth1,int dstDay1,int time1,int dstDelta)

   其中，dstDelta是夏令时期间节约的毫秒数。
   第4个SimpleTimeZone构造函数以下：

SimpleTimeZone(int timeDelta,String tzId,int dstMonth0,int dstDayInMonth0,int dstDay0,int time0,int time0mode,int dstMonth1,int dstDayInMonth1,int dstDay1,int time1,int time1mode,int dstDelta)

   其中，time0mode指定了开始时间的模式，time1mode指定告终束时间的模式。有效的模式值包括：STANDARD_TIME、WALL_TIME、UTC_TIME
   时间模式指示如何解释时间。其余构造函数默认模式WALL_TIME。

Locale 类

   使用Locale类实例化的对象，用于描述地理或文化上的区域。Locale类是为数很少的几个类之一，使用这几个类能够编写可以在不一样国际化环境中运行的Java程序。例如在不一样的区域，用于显示日期、时间和数字的格式是不一样的。
   国际化是一个很大的主题。可是，许多程序只须要处理基本问题，包括设置当前地区。
   Locale类定义了如下常量，对于应对大部分常见地区来讲，这些常量是有用的：

   例如，表达式Locale.CANADA是表示加拿大地区的Locale对象。
   Locale类的构造函数以下：

Locale(String language)
Locale(String language,String country)
Locale(String language,String country,String variant)

   这些构造函数用来构建表示特定语言以及特定国家(对于后面两个构造函数)的Locale对象。这些值必须包含标准语言和国家代码。辅助信息能够经过variant提供。
   Locale类定义了一些方法。其中最重要的方法之一是setDefault(),以下所示：

static void setDefault(Locale localeObj)

   下面是其余一些方法：

final String getDisplayCountry()
final String getDisplayLanguage()
final String getDisplayName()

   这些方法返回人类可以阅读的字符串，这些字符串用于显示国家的名称、语言的名称以及地区的完整描述。
   使用getDefault()方法能够获取默认地区，以下所示：

static Locale getDefault()

   JDK7对Locale类进行了重要升级、新的Locale类可以支持互联网工程任务组BCP47和Unicode技术标准35,其中前者定义了用来标识语言的标签，后者定义了地区数据标记语言。对BCP47和UTS35的支持致使为Locale类添加了几种特性，包括一些新方法和Locale.Builder类。在这些新特性中，新方法包括getScript()和toLanguageTag(),前者获取地区的脚本，后者获取包含地区语言标签的字符串。Locale.Builder类来构造Locale实例，确保地区说明被很好地根据BCP47定义的要求进行了形式化(Locale构造函数没有提供这一检查)。JDK8也为Locale类添加了一些方法，以支持筛选。扩展和查找等操做。    Calendar和GregorianCalendar是以地区敏感方式使用的类的例子。DateFormat和SimpleDateFormat也依赖于地区。