Java Calendar類別使用

「Calendar」類別是一個抽象類別，提供方法用於特定時間片刻與一組日曆欄位(例如,YEAR,HOUR)之間的轉換， 並且處理日曆欄位(舉例，如取得下星期的日期)。

1. 常用日曆屬性

• 本月份的第幾週、當年度的第幾日或第幾週 

          以下表格的屬性需配合Calendar的get與set方法一起使用：

static int DAY_OF_WEEK_IN_MONTH	表示在當月份內的第幾週的欄位代碼
static int WEEK_OF_MONTH	表示在當月份內的第幾週的欄位代碼
static int DAY_OF_YEAR	表示在一年中的第幾日的欄位代碼
static int WEEK_OF_YEAR	表示在一年中第幾週的欄位代碼

• 年份
  

          以下表格的屬性需配合Calendar的get與set方法一起使用：

static int YEAR

表示年的欄位代碼

• 月份
  

          以下表格使用公曆(Gregorian)和朱利安(Julian)日曆 ：

static int JANUARY	表示一年中的第一個月的MONTH欄位代碼
static int FEBRUARY	表示一年中的第二個月的MONTH欄位代碼
static int MARCH	表示一年中的第三個月的MONTH欄位代碼
static int APRIL	表示一年中的第四個月的MONTH欄位代碼
static int MAY	表示一年中的第五個月的MONTH欄位代碼
static int JUNE	表示一年中的第六個月的MONTH欄位代碼
static int JULY	表示一年中的第七個月的MONTH欄位代碼
static int AUGUST	表示一年中的第八個月的MONTH欄位代碼
static int SEPTEMBER	表示一年中的第九個月的MONTH欄位代碼
static int OCTOBER	表示一年中的第十個月的MONTH欄位代碼
static int NOVEMBER	表示一年中的第十一個月的MONTH欄位代碼
static int DECEMBER	表示一年中的第十二個月的MONTH欄位代碼
static int MONTH	表示月份的欄位代碼，用於get和set方法

• 星期

static int MONDAY	表示星期一的DAY_OF_WEEK欄位代碼
static int TUESDAY	表示星期二的DAY_OF_WEEK欄位代碼
static int WEDNESDAY	表示星期三的DAY_OF_WEEK欄位代碼
static int THURSDAY	表示星期四的DAY_OF_WEEK欄位代碼
static int FRIDAY	表示星期五的DAY_OF_WEEK欄位代碼
static int SATURDAY	表示星期六的DAY_OF_WEEK欄位代碼
static int SUNDAY	表示星期日的DAY_OF_WEEK欄位代碼
static int DAY_OF_WEEK	表示一週中的星期幾的欄位代碼，用於get和set方法

• 日

           以下表格的屬性需配合Calendar的get與set方法一起使用：

static int DATE	表示目前月份中的日子的欄位代碼
static int DAY_OF_MONTH	表示目前月份中的日子的欄位代碼

• 白天 / 夜晚
  

static int AM	表示從午夜到中午之前的一天內AM_PM欄位代碼
static int PM	表示從中午到午夜前一天內AM_PM欄位代碼
static int AM_PM	表示小時是否在中午之前或之後的欄位代碼，用於get和set方法

• 時
  

          以下表格用於Calendar的get和set方法：

static int HOUR	表示現在的時刻的欄位代碼，以12小時制
static int HOUR_OF_DAY	表示現在的時刻的欄位代碼，以24小時制

• 分
  

          以下表格用於Calendar的get和set方法：

static int MINUTE

表示在一小時內的分鐘的欄位數值

• 秒
  

          以下表格用於Calendar的get和set方法：

static int SECOND	表示在一分鐘內的秒數的欄位數值
static int MILLISECOND	表示在一秒中的毫秒的欄位數值

• 混合使用常用屬性

          舉個例子，若要產生2012/7/17的日期樣式，我們就需要混合使用上述日曆常用屬性。

2. 常用方法

• 創建日曆實體

static Calendar getInstance()
  取得日曆，使用預設時區與語系。

static Calendar getInstance(Locale aLocale)
  依指定語系來取得日曆。

static Calendar getInstance(TimeZone zone)
  依指定時區來取得日曆。

static Calendar getInstance(TimeZone zone, Locale aLocale)
  依指定時區和指定語系來取得日曆。

• 依給定的欄位代碼，取得、增加、設定數值

int get(int field)
  回傳給定日曆欄位值。

abstract void add(int field, int amount)
  增加或減少特定時間的數量到給定的日曆欄位，根據日曆的規則。

void set(int field, int value)
  設定指定日曆欄位並賦予給定值。

void set(int year, int month, int date)
  針對日曆欄位的年、月、日來設定值。

void set(int year, int month, int date, int hourOfDay, int minute)
  針對日曆欄位的年、月、日、時、分來設定值。

void set(int year, int month, int date, int hourOfDay, int minute, int second)
  針對日曆欄位的年、月、日、時、分、秒來設定值。

• 取得與設定日期

Date getTime()
  回傳代表目前日曆時間值的時期物件。

void setTime(Date date)
  依給定日期值來設定目前的日曆時間。

• 取得與設定時區

TimeZone getTimeZone()
  取得時區。

void setTimeZone(TimeZone value)
  依給定的TimeZone值來設定時區。

• 取得與設定一星期的第一天

int getFirstDayOfWeek()
  取得一星期中的第一天，例如美國是星期日、法國是星期一。

void setFirstDayOfWeek(int value)
  設定一星期中的第一天。

• 取得與設定毫秒

long getTimeInMillis()
  回傳以毫秒表示的目前日曆時戳值。

void setTimeInMillis(long millis)
  依給定的long值來設定目前日曆的現在時間。

• 比較日期

boolean after(Object when)
  回傳目前日曆時間是否在指定日曆時間之後，若是則為真值(true)

boolean before(Object when)
  回傳目前日曆時間是否在指定日曆時間之前，若是則為真值(true)

int compareTo(Calendar anotherCalendar)
  比較兩個日曆時間的大小。

boolean equals(Object obj)
  比較目前日曆時間與指定日曆時間是否相等。