javax.xml.datatype
類別 XMLGregorianCalendar

java.lang.Object
  javax.xml.datatype.XMLGregorianCalendar

所有已實作的介面：

Cloneable

public abstract class XMLGregorianCalendar
extends Object
implements Cloneable

W3C XML 網要 1.0 日期/時間資料型別的表示形式。明確地說，這些日期/時間資料型別是 XML 名稱空間 "http://www.w3.org/2001/XMLSchema" 中定義的 dateTime、time、date、gYearMonth、gMonthDay、gYear gMonth 和 gDay。在 W3C XML 網要 1.0 第二部分 3.2.7-14 節中以標準形式定義了這些資料型別。

下表定義了 XML 網要 1.0 日期/時間資料型別欄位和此類別的欄位之間的映射關係。還總結了 W3C XML 網要 1.0 第二部分的附錄 D ISO 8601 Date and Time Formats 中定義的日期和時間欄位的值約束。

XML 網要 1.0 和 Java 表示形式之間的日期/時間資料型別欄位映射關係
XML 網要 1.0 資料型別 欄位	相關的 XMLGregorianCalendar Accessor(s)	值範圍
year	getYear() + getEon() 或 getEonAndYear()	getYear() 是 -(10^9-1) 到 (10^9)-1 或 DatatypeConstants.FIELD_UNDEFINED 之間的值。 getEon() 是以十億年為單位的高順序年值。 getEon() 是大於或等於 (10^9) 或者小於或等於 -(10^9) 的值。null 值指示欄位未定義。 若 XML 網要 1.0 勘誤表說明 year 0 是 XML 網要以後版本中的一個有效詞彙值，那麼此類別允許將 year 欄位設置為0。否則，完全按照勘誤表和 [ISO-8601-1988] 中的描述處理 year 欄位值。注意，W3C XML 網要 1.0 驗證不允許 year 欄位具有 0 值。
month	getMonth()	1 到 12 或 DatatypeConstants.FIELD_UNDEFINED
day	getDay()	與 month 無關，最大範圍是 1 到 31 或 DatatypeConstants.FIELD_UNDEFINED。 相對於 month 欄位的值說明的標準化值約束位於 W3C XML 網要 1.0 第二部分附錄 D 中。
hour	getHour()	0 到 24 或 DatatypeConstants.FIELD_UNDEFINED。對於值 24，根據 XML 網要勘誤表，minute 和 second 欄位必須為 0。
minute	getMinute()	0 到 59 或 DatatypeConstants.FIELD_UNDEFINED
second	getSecond() + getMillisecond()/1000 或 getSecond() + getFractionalSecond()	getSecond() 範圍是 0 到 60 或 DatatypeConstants.FIELD_UNDEFINED。 （註：60 僅允許閏秒。） 在定義 getSecond() 時，getFractionalSecond() 在範圍 0.0 到 1.0 上允許無限精度。 FractionalSecond 是可選的，並且當它未定義時，值為 null。 getMillisecond() 是值 getFractionalSecond() 的有用毫秒精度。
timezone	getTimezone()	分鐘數或 DatatypeConstants.FIELD_UNDEFINED。從 -14 小時（-14 * 60 分鐘）到 14 小時（14 * 60 分鐘）的值範圍。

通過此類別的處理器方法、DatatypeFactory、設置方法和解析方法檢查上面表中為欄位列出的所有最大值空間約束。若參數的值超出欄位的值約束，或者復合值組成一個無效 XMLGregorianCalendar 實例（例如，如果指定六月的第 31 日），則拋出 IllegalArgumentException。

為此類別定義以下操作：

• 用於獨立日期/時間欄位的 accessors/mutators
• 此類別與 W3C XML 網要 1.0 詞彙表示形式、toString()、DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation) 之間的轉換
• 此類別與 GregorianCalendar、toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults)、DatatypeFactory 之間的轉換
• 部分順序關係比較器方法 compare(XMLGregorianCalendar xmlGregorianCalendar)
• 相對於 compare(XMLGregorianCalendar xmlGregorianCalendar) 定義的 equals(Object)。
• W3C XML 網要 1.0 第二部分的附錄 E Adding durations to dateTimes 中定義的 Duration 實例的其他操作。

從以下版本開始：

1.5

另請參見：

Duration, DatatypeFactory

建構子摘要

XMLGregorianCalendar()
預設的無參數建構子。

方法摘要

abstract void	add(Duration duration) 將 duration 添加到此實例。
abstract void	clear() 取消設置所有未定義的欄位。
abstract Object	clone() 創建並返回此物件的一個副本。
abstract int	compare(XMLGregorianCalendar xmlGregorianCalendar) 根據 W3C XML 網要 1.0 第二部分 3.2.7.3 小節 Order relation on dateTime 中定義的部分順序關係，比較 W3C XML 網要 1.0 日期/時間資料型別的兩個實例。
boolean	equals(Object obj) 將此日曆與指定的物件進行比較。
abstract int	getDay() 返回月中的日或 DatatypeConstants.FIELD_UNDEFINED。
abstract BigInteger	getEon() 返回 year XML 網要 1.0 日期時間資料型別欄位的高順序元件。
abstract BigInteger	getEonAndYear() 返回 year XML 網要 1.0 的日期時間資料型別欄位。
abstract BigDecimal	getFractionalSecond() 返回小數秒。
abstract int	getHour() 返回時或 DatatypeConstants.FIELD_UNDEFINED。
int	getMillisecond() 返回 getFractionalSecond() 的毫秒精度。
abstract int	getMinute() 返回分或 DatatypeConstants.FIELD_UNDEFINED。
abstract int	getMonth() 返回月數或 DatatypeConstants.FIELD_UNDEFINED。
abstract int	getSecond() 返回秒或 DatatypeConstants.FIELD_UNDEFINED。
abstract int	getTimezone() 返回以分為單位的時區偏移量，如果未定義此可選欄位，則返回 DatatypeConstants.FIELD_UNDEFINED。
abstract TimeZone	getTimeZone(int defaultZoneoffset) 返回此類別的 java.util.TimeZone。
abstract QName	getXMLSchemaType() 返回此實例映射到的 XML 網要日期/時間型別的名稱。
abstract int	getYear() 返回 year 或 DatatypeConstants.FIELD_UNDEFINED XML 網要 1.0 日期時間資料型別欄位的低順序元件。
int	hashCode() 返回與 equals 方法的定義一致的雜湊碼。
abstract boolean	isValid() 通過 getXMLSchemaType() 約束來驗證實例。
abstract XMLGregorianCalendar	normalize() 將此實例標準化為 UTC。
abstract void	reset() 將此 XMLGregorianCalendar 重設為其原始值。
abstract void	setDay(int day) 設置月中的日。
abstract void	setFractionalSecond(BigDecimal fractional) 設置小數秒。
abstract void	setHour(int hour) 設置小時。
abstract void	setMillisecond(int millisecond) 設置毫秒。
abstract void	setMinute(int minute) 設置分。
abstract void	setMonth(int month) 設置月。
abstract void	setSecond(int second) 設置秒。
void	setTime(int hour, int minute, int second) 將時間設置為一個單元。
void	setTime(int hour, int minute, int second, BigDecimal fractional) 將時間設置為一個單元，包括可選無限精度小數秒。
void	setTime(int hour, int minute, int second, int millisecond) 將時間設置為一個單元，包括可選的毫秒。
abstract void	setTimezone(int offset) 設置時區偏移量中的分鐘數。
abstract void	setYear(BigInteger year) 設置 XSD dateTime year 欄位的低和高順序元件。
abstract void	setYear(int year) 設置 XSD dateTime year 欄位的年。
abstract GregorianCalendar	toGregorianCalendar() 將此 XMLGregorianCalendar 轉換為 GregorianCalendar。
abstract GregorianCalendar	toGregorianCalendar(TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults) 將此 XMLGregorianCalendar 以及提供的參數轉換為 GregorianCalendar 實例。
String	toString() 返回此 XMLGregorianCalendar Object 的 String 表示形式。
abstract String	toXMLFormat() 返回 this 實例的詞彙表示形式。

從類別 java.lang.Object 繼承的方法

finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

XMLGregorianCalendar

public XMLGregorianCalendar()

預設的無參數建構子。

註：總是使用 DatatypeFactory 來建構 XMLGregorianCalendar 實例。無法保證該類別上的建構子產生具有一致狀態且可在以後移除的物件。

方法詳細資訊

clear

public abstract void clear()

取消設置所有未定義的欄位。

將所有 int 欄位設置為 DatatypeConstants.FIELD_UNDEFINED，並將參考欄位設置為 null。

reset

public abstract void reset()

將此 XMLGregorianCalendar 重設為其原始值。

將 XMLGregorianCalendar 重置為與使用 DatatypeFactory.newXMLGregorianCalendar()、DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation)、DatatypeFactory.newXMLGregorianCalendar( BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone)、DatatypeFactory.newXMLGregorianCalendar( int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone)、DatatypeFactory.newXMLGregorianCalendar(GregorianCalendar cal)、DatatypeFactory.newXMLGregorianCalendarDate( int year, int month, int day, int timezone)、DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, int timezone)、DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone) 或 DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, int milliseconds, int timezone) 創建時相同的值。

reset() 的設計目的是允許重用現有的 XMLGregorianCalendar，從而節省與創建新 XMLGregorianCalendar 相關的資源。

setYear

public abstract void setYear(BigInteger year)

設置 XSD dateTime year 欄位的低和高順序元件。

通過使用參數值 null 調用設置方法取消設置此欄位。

參數：

year - 日期/時間欄位映射表中 year 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 year 參數超出日期/時間映射表中指定欄位的值約束。

setYear

public abstract void setYear(int year)

設置 XSD dateTime year 欄位的年。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

註：如果 year 參數的絕對值小於 10^9，則通過此方法將 XSD year 欄位的 eon 元件設置為 null。

參數：

year - 日期/時間欄位映射表中 year 欄位中總結的值約束。如果 year 是 DatatypeConstants.FIELD_UNDEFINED，那麼將 eon 設置為 null。

setMonth

public abstract void setMonth(int month)

設置月。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

month - 日期/時間映射表的 month 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 month 參數超出日期/時間映射表中指定欄位的值約束。

setDay

public abstract void setDay(int day)

設置月中的日。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

day - 日期/時間欄位映射表的 day 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 day 參數超出日期/時間映射表中指定欄位的值約束。

setTimezone

public abstract void setTimezone(int offset)

設置時區偏移量中的分鐘數。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

offset - 日期/時間欄位映射表的 timezone 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 offset 參數超出日期/時間映射表中指定欄位的值約束。

setTime

public void setTime(int hour,
                    int minute,
                    int second)

將時間設置為一個單元。

參數：

hour - 日期/時間欄位映射表的 hour 欄位中總結的值約束。

minute - 日期/時間欄位映射表的 minute 欄位中總結的值約束。

second - 日期/時間欄位映射表的 second 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果任何參數超出日期/時間映射表中指定欄位的值約束。

另請參見：

setTime(int, int, int, BigDecimal)

setHour

public abstract void setHour(int hour)

設置小時。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

hour - 日期/時間欄位映射表的 hour 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 hour 參數超出日期/時間映射表中指定欄位的值約束。

setMinute

public abstract void setMinute(int minute)

設置分。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

minute - 日期/時間欄位映射表的 minute 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 minute 參數超出日期/時間映射表中指定欄位的值約束。

setSecond

public abstract void setSecond(int second)

設置秒。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

second - 日期/時間欄位映射表的 second 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 second 參數超出日期/時間映射表中指定欄位的值約束。

setMillisecond

public abstract void setMillisecond(int millisecond)

設置毫秒。

通過使用 DatatypeConstants.FIELD_UNDEFINED 的參數值調用設置方法取消設置此欄位。

參數：

millisecond - 日期/時間欄位映射表的 second 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 millisecond 參數超出日期/時間映射表中指定欄位的值約束。

setFractionalSecond

public abstract void setFractionalSecond(BigDecimal fractional)

設置小數秒。

通過使用參數值 null 調用設置方法取消設置此欄位。

參數：

fractional - 日期/時間欄位映射表的 second 欄位中總結的值約束。

拋出：

IllegalArgumentException - 如果 fractional 參數超出日期/時間映射表中指定欄位的值約束。

setTime

public void setTime(int hour,
                    int minute,
                    int second,
                    BigDecimal fractional)

將時間設置為一個單元，包括可選無限精度小數秒。

參數：

hour - 日期/時間欄位映射表的 hour 欄位中總結的值約束。

minute - 日期/時間欄位映射表的 minute 欄位中總結的值約束。

second - 日期/時間欄位映射表的 second 欄位中總結的值約束。

fractional - 值 null 指示不設置此可選欄位。

拋出：

IllegalArgumentException - 如果任何參數超出日期/時間映射表中指定欄位的值約束。

setTime

public void setTime(int hour,
                    int minute,
                    int second,
                    int millisecond)

將時間設置為一個單元，包括可選的毫秒。

參數：

hour - 日期/時間欄位映射表的 hour 欄位中總結的值約束。

minute - 日期/時間欄位映射表的 minute 欄位中總結的值約束。

second - 日期/時間欄位映射表的 second 欄位中總結的值約束。

millisecond - DatatypeConstants.FIELD_UNDEFINED 的值指示未設置此可選欄位。

拋出：

IllegalArgumentException - 如果任何參數超出日期/時間映射表中指定欄位的值約束。

getEon

public abstract BigInteger getEon()

返回 year XML 網要 1.0 日期時間資料型別欄位的高順序元件。如果未定義 year 欄位的此可選部分，則返回 null。

日期/時間欄位映射表中 year 欄位中總結了此值的值約束。

返回：

此 XMLGregorianCalendar 的 eon。返回的值是 10^9 的整數倍數。

另請參見：

getYear(), getEonAndYear()

getYear

public abstract int getYear()

返回 year 或 DatatypeConstants.FIELD_UNDEFINED XML 網要 1.0 日期時間資料型別欄位的低順序元件。

日期/時間欄位映射表中 year 欄位中總結了此值的值約束。

返回：

此 XMLGregorianCalendar 的年。

另請參見：

getEon(), getEonAndYear()

getEonAndYear

public abstract BigInteger getEonAndYear()

返回 year XML 網要 1.0 的日期時間資料型別欄位。

日期/時間欄位映射表中 year 欄位中總結了此值的值約束。

返回：

當同時定義了 eon 和 BigInteger.valueOf(year) 兩個欄位時，返回它們的總和。只定義了 year 時，返回 year。當 eon 和 year 都未定義時，返回 null。

另請參見：

getEon(), getYear()

getMonth

public abstract int getMonth()

返回月數或 DatatypeConstants.FIELD_UNDEFINED。

日期/時間映射表的 month 欄位中總結了此值的值約束。

返回：

此 XMLGregorianCalendar 的年。

getDay

public abstract int getDay()

返回月中的日或 DatatypeConstants.FIELD_UNDEFINED。

日期/時間欄位映射表的 day 欄位中總結了此值的值約束。

另請參見：

setDay(int)

getTimezone

public abstract int getTimezone()

返回以分為單位的時區偏移量，如果未定義此可選欄位，則返回 DatatypeConstants.FIELD_UNDEFINED。

日期/時間欄位映射表的 timezone 欄位中總結了此值的值約束。

另請參見：

setTimezone(int)

getHour

public abstract int getHour()

返回時或 DatatypeConstants.FIELD_UNDEFINED。如果未定義此欄位，則返回 DatatypeConstants.FIELD_UNDEFINED。

日期/時間欄位映射表的 hour 欄位中總結了此值的值約束。

另請參見：

setTime(int, int, int)

getMinute

public abstract int getMinute()

返回分或 DatatypeConstants.FIELD_UNDEFINED。

如果未定義此欄位，則返回 DatatypeConstants.FIELD_UNDEFINED。

日期/時間欄位映射表的 minute 欄位中總結了此值的值約束。

另請參見：

setTime(int, int, int)

getSecond

public abstract int getSecond()

返回秒或 DatatypeConstants.FIELD_UNDEFINED。

如果未定義此欄位，則返回 DatatypeConstants.FIELD_UNDEFINED。當未定義此欄位時，不得定義由 getFractionalSecond() 和 getMillisecond() 表示的可選 xs:dateTime 小數 seconds 欄位。

日期/時間欄位映射表的 second 欄位中總結此值的值約束。

返回：

此 XMLGregorianCalendar 的秒。

另請參見：

getFractionalSecond(), getMillisecond(), setTime(int, int, int)

getMillisecond

public int getMillisecond()

返回 getFractionalSecond() 的毫秒精度。

此方法表示由 getFractionalSecond() 返回的無限精度小數秒值的有用存取程序。返回的值是 getFractionalSecond() 的毫秒值的下捨入值。當 getFractionalSecond() 返回 null 時，此方法必須返回 DatatypeConstants.FIELD_UNDEFINED。

日期/時間欄位映射表的 second 欄位中總結此值的值約束。

返回：

此 XMLGregorianCalendar 的毫秒。

另請參見：

getFractionalSecond(), setTime(int, int, int)

getFractionalSecond

public abstract BigDecimal getFractionalSecond()

返回小數秒。

當未定義此可選欄位時，返回 null。

在 日期/時間欄位映射表的 second 欄位中詳細描述了值約束。

當 getSecond() 表示的 xs:dateTime 秒欄位未返回 DatatypeConstants.FIELD_UNDEFINED 時，此可選欄位只能有一個已定義的值。

返回：

此 XMLGregorianCalendar 的小數秒。

另請參見：

getSecond(), setTime(int, int, int, BigDecimal)

compare

public abstract int compare(XMLGregorianCalendar xmlGregorianCalendar)

根據 W3C XML 網要 1.0 第二部分 3.2.7.3 小節 Order relation on dateTime 中定義的部分順序關係，比較 W3C XML 網要 1.0 日期/時間資料型別的兩個實例。

在日期/時間映射表中定義了到此類別的存取程序的 xsd:dateTime 資料型別欄位映射。

參數：

xmlGregorianCalendar - 要比較的 XMLGregorianCalendar 實例

返回：

此 XMLGregorianCalendar 與 xmlGregorianCalendar 之間的關係：DatatypeConstants.LESSER、DatatypeConstants.EQUAL、DatatypeConstants.GREATER 或 DatatypeConstants.INDETERMINATE。

拋出：

NullPointerException - 如果 xmlGregorianCalendar 為 null。

normalize

public abstract XMLGregorianCalendar normalize()

將此實例標準化為 UTC。

2000-03-04T23:00:00+03:00 標準化為 2000-03-04T20:00:00Z

實作 W3C XML 網要 第二部分 3.2.7.3 (A) 節。

返回：

標準化為 UTC 的此 XMLGregorianCalendar。

equals

public boolean equals(Object obj)

將此日曆與指定的物件進行比較。當且僅當該參數不為 null，並且是表示與該物件相同時點的 XMLGregorianCalendar 物件時，結果才為 true。

覆寫：

類別 Object 中的 equals

參數：

obj - 要比較的物件。

返回：

當 obj 是 XMLGregorianCalendar 的實例，並且 compare(XMLGregorianCalendar obj) 返回 DatatypeConstants.EQUAL 時，返回 true，否則返回 false。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回與 equals 方法的定義一致的雜湊碼。

覆寫：

類別 Object 中的 hashCode

返回：

此物件的雜湊碼。

另請參見：

Object.equals(java.lang.Object), Hashtable

toXMLFormat

public abstract String toXMLFormat()

返回 this 實例的詞彙表示形式。在 XML 網要 1.0 第二部分 3.2.[7-14].1 小節 "Lexical Representation". 中指定了該格式。

getXMLSchemaType() 確定特定目標詞彙表示形式的格式。

返回：

XML，此 XMLGregorianCalendar 的 String 表示形式

拋出：

IllegalStateException - 如果設置欄位的組合與定義的八個 XML 網要內置日期/時間資料型別之一不比對。

getXMLSchemaType

public abstract QName getXMLSchemaType()

返回此實例映射到的 XML 網要日期/時間型別的名稱。該型別根據設置的欄位來計算。

XML 網要 1.0 日期/時間資料型別的必需欄位。 （對於所有日期/時間資料型別，時區是可選的）
資料型別	year	month	day	hour	minute	second
DatatypeConstants.DATETIME	X	X	X	X	X	X
DatatypeConstants.DATE	X	X	X
DatatypeConstants.TIME				X	X	X
DatatypeConstants.GYEARMONTH	X	X
DatatypeConstants.GMONTHDAY		X	X
DatatypeConstants.GYEAR	X
DatatypeConstants.GMONTH		X
DatatypeConstants.GDAY			X

返回：

以下類別常數之一：DatatypeConstants#DATETIE、DatatypeConstants.TIME、DatatypeConstants.DATE、DatatypeConstants.GYEARMONTH、DatatypeConstants.GMONTHDAY、DatatypeConstants.GYEAR、DatatypeConstants.GMONTH 或 DatatypeConstants.GDAY。

拋出：

IllegalStateException - 如果設置欄位的組合與定義的八個 XML 網要內置日期/時間資料型別之一不比對。

toString

public String toString()

返回此 XMLGregorianCalendar Object 的 String 表示形式。

結果是 toXMLFormat() 產生的詞彙表示形式。

覆寫：

類別 Object 中的 toString

返回：

此 XMLGregorianCalendar 的非 null 有效 String 表示形式。

拋出：

IllegalStateException - 如果設置欄位的組合與定義的八個 XML 網要內置日期/時間資料型別之一不比對。

另請參見：

toXMLFormat()

isValid

public abstract boolean isValid()

通過 getXMLSchemaType() 約束來驗證實例。

返回：

如果資料值有效，則返回 true。

add

public abstract void add(Duration duration)

將 duration 添加到此實例。

計算方式在 XML 網要 1.0 第二部分附錄 E Adding durations to dateTimes> 中指定。日期/時間欄位映射表定義了從 XML 網要 1.0 dateTime 欄位到此類別的這些欄位的表示形式的映射。

參數：

duration - 添加到此 XMLGregorianCalendar 的持續時間。

拋出：

NullPointerException - 當 duration 參數為 null 時。

toGregorianCalendar

public abstract GregorianCalendar toGregorianCalendar()

將此 XMLGregorianCalendar 轉換為 GregorianCalendar。

當 this 實例具有未定義的欄位時，此轉換依賴於其相應欄位的 java.util.GregorianCalendar 預設值。 XML 網要 1.0 日期/時間資料型別和 java.util.GregorianCalendar 之間的顯著差異是時區值對於日期/時間資料型別是可選的，並且它是 java.util.GregorianCalendar 的必需欄位。有關如何確定預設的 java.util.TimeZone.getDefault()，請參閱 javadoc。要顯式指定 TimeZone 實例，請參閱 toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar)。

從此類別到 java.util.GregorianCalendar 的逐欄位轉換
java.util.GregorianCalendar 欄位	javax.xml.datatype.XMLGregorianCalendar 欄位
ERA	getEonAndYear().signum() < 0 ? GregorianCalendar.BC : GregorianCalendar.AD
YEAR	getEonAndYear().abs().intValue()*
MONTH	getMonth() - DatatypeConstants.JANUARY + Calendar.JANUARY
DAY_OF_MONTH	getDay()
HOUR_OF_DAY	getHour()
MINUTE	getMinute()
SECOND	getSecond()
MILLISECOND	從 getFractionalSecond()* 獲取毫秒順序
GregorianCalendar.setTimeZone(TimeZone)	格式化為自定義時區 id 的 getTimezone()

* 由於源資料型別具有比目標資料型別更高的精度，在轉換過程中指定可能丟失的精度。

要確保轉換實作中的一致性，應使用以下方式實例化新的 GregorianCalendar。

• 使用以上定義的 timeZone 值，創建一個新的 java.util.GregorianCalendar(timeZone,Locale.getDefault())。
• 通過調用 Calendar.clear() 初始化所有 GregorianCalendar 欄位。
• 通過調用 GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE)) 獲取純陽曆。
• 使用方法 Calendar.set(int,int) 設置其欄位 ERA、YEAR、MONTH、DAY_OF_MONTH、HOUR_OF_DAY、MINUTE、SECOND 和 MILLISECOND

另請參見：

toGregorianCalendar(java.util.TimeZone, java.util.Locale, XMLGregorianCalendar)

toGregorianCalendar

public abstract GregorianCalendar toGregorianCalendar(TimeZone timezone,
                                                      Locale aLocale,
                                                      XMLGregorianCalendar defaults)

將此 XMLGregorianCalendar 以及提供的參數轉換為 GregorianCalendar 實例。

由於 XML 網要 1.0 日期/時間日期型別沒有時區 id 或夏令時 id 的概念，所以此轉換操作允許使用者使用 timezone 參數顯式指定一個 id。

要計算返回值的 TimeZone 欄位，

• 當參數 timeZone 為非 null 時，它是時區欄位。
• 當 this.getTimezone() != FIELD_UNDEFINED 時，使用 this.getTimezone() 創建帶有自定義時區 id 的 java.util.TimeZone。
• 當 defaults.getTimezone() != FIELD_UNDEFINED 時，使用 this.getTimezone() 創建帶有自定義時區 id 的 defaults.getTimezone()。
• 另外,對主機使用 GregorianCalendar 預設時區值按 java.util.TimeZone.getDefault() 指定的方式定義。

要確保轉換實作中的一致性，應使用以下方式實例化新的 GregorianCalendar。

• 使用上面指定的時區設置和 Locale 參數創建新的 java.util.GregorianCalendar(TimeZone, Locale)。
• 通過調用 Calendar.clear() 初始化所有 GregorianCalendar 欄位
• 通過調用 GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE)) 獲取純陽曆。
• 使用方法 Calendar.set(int,int) 設置其欄位 ERA、YEAR、MONTH、DAY_OF_MONTH、HOUR_OF_DAY、MINUTE、SECOND 和 MILLISECOND

參數：

timezone - 提供時區。null 是一個合法值。

aLocale - 提供明確的語言環境。如果值為 null，則使用預設 GregorianCalendar 語言環境。

defaults - 當此實例的相應欄位為 FIELD_UNDEFINED 或 null 時，它提供要使用的預設欄位值。如果 defaults 為 null 或指定 defaults 中的欄位未定義，則僅使用 java.util.GregorianCalendar 預設值。

返回：

此實例的 java.util.GregorianCalendar 轉換。

getTimeZone

public abstract TimeZone getTimeZone(int defaultZoneoffset)

返回此類別的 java.util.TimeZone。

如果未定義此實例的時區欄位，則返回使用時區偏移量的自定義時區 id 初始化的 TimeZone。如果未定義時區欄位，則嘗試傳入的 defaultZoneoffset。如果 defaultZoneoffset 為 FIELD_UNDEFINED，則返回此主機的預設時區。（與 java.util.GregorianCalendar 相同的預設值）。

參數：

defaultZoneoffset - 如果此時區偏移量為 DatatypeConstants.FIELD_UNDEFINED，則為預設時區偏移量。

返回：

為其返回 TimeZone。

clone

public abstract Object clone()

創建並返回此物件的一個副本。

覆寫：

類別 Object 中的 clone

返回：

此 Object 的副本。

另請參見：

Cloneable