Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class XMLGregorianCalendar extends Object implements Cloneable
Представление для типов данных даты/времени XML-схемы 1.0 W3C. Определенно, эти типы данных даты/времени DatatypeConstants.DATETIME
, DatatypeConstants.TIME
, DatatypeConstants.DATE
, DatatypeConstants.GYEARMONTH
, DatatypeConstants.GMONTHDAY
, DatatypeConstants.GYEAR
, DatatypeConstants.GMONTH
, и DatatypeConstants.GDAY
определенный в XML Пространство имен "http://www.w3.org/2001/XMLSchema"
. Эти типы данных нормативно определяются в
Таблица ниже определяет отображение между полями типа данных даты/времени XML-схемы 1.0 и этим class' поля. Это также суммирует ограничения значения для даты и полей времени, определенных в
Поле Типа данных даты/Времени, Отображающееся Между XML-схемой 1.0 и Представлением Java | ||
---|---|---|
XML-схема 1.0 тип данных поле |
Связанный XMLGregorianCalendar Средство (а) доступа |
Диапазон значений |
год | getYear() + getEon() илиgetEonAndYear()
|
getYear() значение между - (10^9-1) к (10^9)-1 или DatatypeConstants.FIELD_UNDEFINED .getEon() значение года старшего разряда через миллиард лет.getEon() имеет значения, больше чем или равный (10^9) или меньше чем или равный - (10^9). Значение нуля указывает, что поле неопределено. Given that Опечатки XML-схемы 1.0 утверждают, что нуль года будет допустимым лексическим значением в будущей версии XML-схемы, этот class позволяет полю года быть обнуленным. Иначе, значение поля года обрабатывается точно как описано в опечатках и [ISO-8601-1988]. Отметьте, что проверка допустимости XML-схемы 1.0 W3C не учитывает поле года, чтобы иметь значение нуля. |
месяц | getMonth() |
1 - 12 или DatatypeConstants.FIELD_UNDEFINED |
день | getDay() |
Независимый от месяца, максимальный диапазон 1 - 31 или DatatypeConstants.FIELD_UNDEFINED .Нормативное ограничение значения, утвержденное относительно месяца значение поля, находится в |
час | getHour() |
От 0 до 23 или DatatypeConstants.FIELD_UNDEFINED . Значению часа 24 позволяют быть установленным в лексическом пространстве, если минута и вторые значения полей являются нулем. Однако, значение часа 24 не позволяется в пространстве значений и будет преобразовано, чтобы представить значение первой инстанции следующего дня согласно |
минута | getMinute() |
От 0 до 59 или DatatypeConstants.FIELD_UNDEFINED |
второй |
getSecond() + getMillisecond() /1000 илиgetSecond() + getFractionalSecond()
|
getSecond() от 0 до 60 или DatatypeConstants.FIELD_UNDEFINED .(Отметьте: 60 только допустимый для второго прыжка.) getFractionalSecond() учитывает бесконечную точность по диапазону от 0.0 до 1.0 когда getSecond() определяется.FractionalSecond является дополнительным и имеет значение null когда это неопределено.getMillisecond() точность миллисекунды удобства значения getFractionalSecond() . |
часовой пояс | getTimezone() |
Число минут или DatatypeConstants.FIELD_UNDEFINED . Диапазон значений с-14 часов (-14 * 60 минут) к 14 часам (14 * 60 минут). |
Все максимальные ограничения пространства значений, перечисленные для полей в таблице выше, проверяются методами фабрики, {соединяют DatatypeFactory}, методы метода set и анализируют методы этого class. IllegalArgumentException
бросается, когда значение параметра вне ограничения значения для поля или если составные значения составляют недопустимый экземпляр XMLGregorianCalendar (например, если 31-ого июня определяется).
Следующие операции определяются для этого class:
toString()
, DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation)
GregorianCalendar
, toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults)
, DatatypeFactory
compare(XMLGregorianCalendar xmlGregorianCalendar)
equals(Object)
определенный относительно compare(XMLGregorianCalendar xmlGregorianCalendar)
.Duration
экземпляр как определено в Duration
, DatatypeFactory
Конструктор и Описание |
---|
XMLGregorianCalendar()
Значение по умолчанию конструктор без аргументов.
|
Модификатор и Тип | Метод и Описание |
---|---|
abstract void |
add(Duration duration)
Добавить
duration к этому экземпляру. |
abstract void |
clear()
Сбросьте все поля к неопределенному.
|
abstract Object |
clone()
Создает и возвращает копию этого объекта.
|
abstract int |
compare(XMLGregorianCalendar xmlGregorianCalendar)
Сравните два экземпляра типов данных даты/времени XML-схемы 1.0 W3C согласно отношению частичного порядка, определенному в
|
boolean |
equals(Object obj)
Сравнивает этот календарь с указанным объектом.
|
abstract int |
getDay()
Возвратите день в месяце или
DatatypeConstants.FIELD_UNDEFINED . |
abstract BigInteger |
getEon()
Возвратите компонент старшего разряда для поля типа данных datetime XML-схемы 1.0 для
year . |
abstract BigInteger |
getEonAndYear()
Возвратите поле типа данных datetime XML-схемы 1.0 для
year . |
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)
Возвраты a
java.util.TimeZone для этого class. |
abstract QName |
getXMLSchemaType()
Возвратите имя типа даты/времени XML-схемы, на который отображается этот экземпляр.
|
abstract int |
getYear()
Возвратите компонент младшего разряда для поля типа данных datetime XML-схемы 1.0 для
year или DatatypeConstants.FIELD_UNDEFINED . |
int |
hashCode()
Возвращается хэш-код, непротиворечивый с определением, равняется методу.
|
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 поле года. |
abstract void |
setYear(int year)
Год набора XSD
dateTime поле года. |
abstract GregorianCalendar |
toGregorianCalendar()
Преобразуйте это
XMLGregorianCalendar к a GregorianCalendar . |
abstract GregorianCalendar |
toGregorianCalendar(TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults)
Преобразуйте это
XMLGregorianCalendar наряду с обеспеченными параметрами к a GregorianCalendar экземпляр. |
Строка |
toString()
Возвраты a
String представление этого XMLGregorianCalendar Object . |
abstract String |
toXMLFormat()
Возвратите лексическое представление
this экземпляр. |
public XMLGregorianCalendar()
Отметьте: Всегда используйте DatatypeFactory
создать экземпляр XMLGregorianCalendar
. Конструктор на этом class, как могут гарантировать, не произведет объект с непротиворечивым состоянием и может быть удален в будущем.
public abstract void clear()
Сбросьте все поля к неопределенному.
Установите все международные поля в DatatypeConstants.FIELD_UNDEFINED
и ссылочные поля к нулю.
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
s таким образом сохраняющий ресурсы, связанные с созданием новых XMLGregorianCalendar
s.
public abstract void setYear(BigInteger year)
Установите компонент младшего и старшего разряда XSD dateTime
поле года.
Сбросьте это поле, вызывая метод set со значением параметра null
.
year
- ограничения значения подводили итог в поле года полевой таблицы отображения даты/времени.IllegalArgumentException
- если year
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setYear(int year)
Год набора XSD dateTime
поле года.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
Отметьте: если абсолютное значение year
параметр является меньше чем 10^9, компонент вечности поля года XSD устанавливается в null
этим методом.
year
- ограничения значения получаются в итоге в поле года полевой таблицы отображения даты/времени. Если год DatatypeConstants.FIELD_UNDEFINED
, тогда вечность устанавливается в null
.public abstract void setMonth(int month)
Месяц набора.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
month
- ограничения значения подводили итог в поле месяца полевой таблицы отображения даты/времени.IllegalArgumentException
- если month
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setDay(int day)
Дни набора в месяце.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
day
- ограничения значения подводили итог в дневном поле полевой таблицы отображения даты/времени.IllegalArgumentException
- если day
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setTimezone(int offset)
Определите номер минут в смещении часового пояса.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
offset
- ограничения значения подводили итог в поле часового пояса полевой таблицы отображения даты/времени.IllegalArgumentException
- если offset
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public void setTime(int hour, int minute, int second)
Время набора как один модуль.
hour
- ограничения значения получаются в итоге в поле часа полевой таблицы отображения даты/времени.minute
- ограничения значения получаются в итоге в мелком поле полевой таблицы отображения даты/времени.second
- ограничения значения получаются в итоге во втором поле полевой таблицы отображения даты/времени.IllegalArgumentException
- если какой-либо параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.setTime(int, int, int, BigDecimal)
public abstract void setHour(int hour)
Часы набора.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
hour
- ограничения значения подводили итог в поле часа полевой таблицы отображения даты/времени.IllegalArgumentException
- если hour
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setMinute(int minute)
Минуты набора.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
minute
- ограничения значения подводили итог в мелком поле полевой таблицы отображения даты/времени.IllegalArgumentException
- если minute
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setSecond(int second)
Секунды набора.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
second
- ограничения значения подводили итог во втором поле полевой таблицы отображения даты/времени.IllegalArgumentException
- если second
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setMillisecond(int millisecond)
Миллисекунды набора.
Сбросьте это поле, вызывая метод set со значением параметра DatatypeConstants.FIELD_UNDEFINED
.
millisecond
- ограничения значения подводили итог во втором поле полевой таблицы отображения даты/времени.IllegalArgumentException
- если millisecond
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract void setFractionalSecond(BigDecimal fractional)
Установите доли секунды.
Сбросьте это поле, вызывая метод set со значением параметра null
.
fractional
- ограничения значения подводили итог во втором поле полевой таблицы отображения даты/времени.IllegalArgumentException
- если fractional
параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public void setTime(int hour, int minute, int second, BigDecimal fractional)
Время набора как один модуль, включая дополнительные бесконечные доли секунды точности.
hour
- ограничения значения получаются в итоге в поле часа полевой таблицы отображения даты/времени.minute
- ограничения значения получаются в итоге в мелком поле полевой таблицы отображения даты/времени.second
- ограничения значения получаются в итоге во втором поле полевой таблицы отображения даты/времени.fractional
- значение null
указывает, что это дополнительное поле не устанавливается.IllegalArgumentException
- если какой-либо параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public void setTime(int hour, int minute, int second, int millisecond)
Время набора как один модуль, включая дополнительные миллисекунды.
hour
- ограничения значения получаются в итоге в поле часа полевой таблицы отображения даты/времени.minute
- ограничения значения получаются в итоге в мелком поле полевой таблицы отображения даты/времени.second
- ограничения значения получаются в итоге во втором поле полевой таблицы отображения даты/времени.millisecond
- значение DatatypeConstants.FIELD_UNDEFINED
указывает, что это дополнительное поле не устанавливается.IllegalArgumentException
- если какой-либо параметр является внешними ограничениями значения для поля как определено в полевой таблице отображения даты/времени.public abstract BigInteger getEon()
Возвратите компонент старшего разряда для поля типа данных datetime XML-схемы 1.0 для year
. null
если эта дополнительная часть поля года не определяется.
Ограничения значения для этого значения получаются в итоге в поле года полевой таблицы отображения даты/времени.
XMLGregorianCalendar
. Возвращенное значение является целочисленным кратным числом 10^9.getYear()
, getEonAndYear()
public abstract int getYear()
Возвратите компонент младшего разряда для поля типа данных datetime XML-схемы 1.0 для year
или DatatypeConstants.FIELD_UNDEFINED
.
Ограничения значения для этого значения получаются в итоге в поле года полевой таблицы отображения даты/времени.
XMLGregorianCalendar
.getEon()
, getEonAndYear()
public abstract BigInteger getEonAndYear()
Возвратите поле типа данных datetime XML-схемы 1.0 для year
.
Ограничения значения для этого значения получаются в итоге в поле года полевой таблицы отображения даты/времени.
public abstract int getMonth()
Возвратите число месяца или DatatypeConstants.FIELD_UNDEFINED
.
Ограничения значения для этого значения получаются в итоге в поле месяца полевой таблицы отображения даты/времени.
XMLGregorianCalendar
.public abstract int getDay()
DatatypeConstants.FIELD_UNDEFINED
.
Ограничения значения для этого значения получаются в итоге в дневном поле полевой таблицы отображения даты/времени.
setDay(int)
public abstract int getTimezone()
DatatypeConstants.FIELD_UNDEFINED
если это дополнительное поле не определяется. Ограничения значения для этого значения получаются в итоге в поле часового пояса полевой таблицы отображения даты/времени.
setTimezone(int)
public abstract int getHour()
DatatypeConstants.FIELD_UNDEFINED
. Возвраты DatatypeConstants.FIELD_UNDEFINED
если это поле не определяется. Ограничения значения для этого значения получаются в итоге в поле часа полевой таблицы отображения даты/времени.
setTime(int, int, int)
public abstract int getMinute()
DatatypeConstants.FIELD_UNDEFINED
. Возвраты DatatypeConstants.FIELD_UNDEFINED
если это поле не определяется. Ограничения значения для этого значения получаются в итоге в мелком поле полевой таблицы отображения даты/времени.
setTime(int, int, int)
public abstract int getSecond()
Возвратите секунды или DatatypeConstants.FIELD_UNDEFINED
.
Возвраты DatatypeConstants.FIELD_UNDEFINED
если это поле не определяется. Когда это поле не определяется, дополнительное xs:dateTime поле долей секунды, представленное getFractionalSecond()
и getMillisecond()
, не должен быть определен.
Ограничения значения для этого значения получаются в итоге во втором поле полевой таблицы отображения даты/времени.
XMLGregorianCalendar
.getFractionalSecond()
, getMillisecond()
, setTime(int, int, int)
public int getMillisecond()
Возвратите точность миллисекунды getFractionalSecond()
.
Этот метод представляет средство доступа удобства бесконечному значению доли секунды точности, возвращенному getFractionalSecond()
. Возвращенное значение является округленным в меньшую сторону до значения миллисекунд getFractionalSecond()
. Когда getFractionalSecond()
возвраты null
, этот метод должен возвратиться DatatypeConstants.FIELD_UNDEFINED
.
Ограничения значения для этого значения получаются в итоге во втором поле полевой таблицы отображения даты/времени.
XMLGregorianCalendar
.getFractionalSecond()
, setTime(int, int, int)
public abstract BigDecimal getFractionalSecond()
Возвратите доли секунды.
null
возвращается, когда это дополнительное поле не определяется.
Ограничения значения детализируются во втором поле полевой таблицы отображения даты/времени.
У этого дополнительного поля может только быть определенное значение когда xs:dateTime второе поле, представленное getSecond()
, не возвращается DatatypeConstants.FIELD_UNDEFINED
.
XMLGregorianCalendar
.getSecond()
, setTime(int, int, int, BigDecimal)
public abstract int compare(XMLGregorianCalendar xmlGregorianCalendar)
Сравните два экземпляра типов данных даты/времени XML-схемы 1.0 W3C согласно отношению частичного порядка, определенному в
xsd:dateTime
поле типа данных, отображающееся на средства доступа этого class, определяется в полевой таблице отображения даты/времени.
xmlGregorianCalendar
- Экземпляр XMLGregorianCalendar
сравнитьсяthis
XMLGregorianCalendar
и указанное xmlGregorianCalendar
как DatatypeConstants.LESSER
, DatatypeConstants.EQUAL
, DatatypeConstants.GREATER
или DatatypeConstants.INDETERMINATE
.NullPointerException
- если xmlGregorianCalendar
нуль.public abstract XMLGregorianCalendar normalize()
Нормализуйте этот экземпляр к UTC.
2000-03-04T23:00:00+03:00 нормализует к 2000-03-04T20:00:00Z
Часть 2 XML-схемы W3C реализаций, Раздел 3.2.7.3 (A).
this
XMLGregorianCalendar
нормализованный к UTC.public boolean equals(Object obj)
Сравнивает этот календарь с указанным объектом. Результат true
если и только если параметр не является нулем и XMLGregorianCalendar
объект, который представляет тот же самый момент вовремя как этот объект.
equals
в class Object
obj
- сравниться.true
когда obj
экземпляр XMLGregorianCalendar
и compare(XMLGregorianCalendar obj)
возвраты DatatypeConstants.EQUAL
, иначе false
.Object.hashCode()
, HashMap
public int hashCode()
Возвращается хэш-код, непротиворечивый с определением, равняется методу.
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public abstract String toXMLFormat()
Возвратите лексическое представление this
экземпляр. Формат определяется в
Определенный целевой лексический формат представления определяется getXMLSchemaType()
.
String
, представление этого XMLGregorianCalendar
IllegalStateException
- если комбинация полей набора не соответствует одну из восьми определенных XML-схем встроенные типы данных даты/времени.public abstract QName getXMLSchemaType()
Возвратите имя типа даты/времени XML-схемы, на который отображается этот экземпляр. Тип вычисляется основанный на полях, которые устанавливаются.
Обязательные поля для Типов данных Даты/Времени XML-схемы 1.0. (часовой пояс является дополнительным для всех типов данных даты/времени), |
||||||
---|---|---|---|---|---|---|
Тип данных | год | месяц | день | час | минута | второй |
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.DATETIME
, DatatypeConstants.TIME
, DatatypeConstants.DATE
, DatatypeConstants.GYEARMONTH
, DatatypeConstants.GMONTHDAY
, DatatypeConstants.GYEAR
, DatatypeConstants.GMONTH
или DatatypeConstants.GDAY
.IllegalStateException
- если комбинация полей набора не соответствует одну из восьми определенных XML-схем встроенные типы данных даты/времени.public String toString()
Возвраты a String
представление этого XMLGregorianCalendar
Object
.
Результатом является лексическое представление, сгенерированное toXMLFormat()
.
toString
в class Object
null
допустимый String
представление этого XMLGregorianCalendar
.IllegalStateException
- если комбинация полей набора не соответствует одну из восьми определенных XML-схем встроенные типы данных даты/времени.toXMLFormat()
public abstract boolean isValid()
getXMLSchemaType()
ограничения.public abstract void add(Duration duration)
Добавить duration
к этому экземпляру.
Вычисление определяется в dateTime
поля к этому class' представление тех полей.
duration
- Продолжительность, чтобы добавить к этому XMLGregorianCalendar
.NullPointerException
- когда duration
параметр null
.public abstract GregorianCalendar toGregorianCalendar()
Преобразуйте это XMLGregorianCalendar
к a GregorianCalendar
.
Когда this
у экземпляра есть неопределенное поле, это преобразование полагается java.util.GregorianCalendar
значение по умолчанию для его соответствующего поля. Заметные различия между типами данных даты/времени XML-схемы 1.0 и java.util.GregorianCalendar
то значение Часового пояса, является дополнительным для типов данных даты/времени, и это - обязательное поле для java.util.GregorianCalendar
. См. javadoc для java.util.TimeZone.getDefault()
на том, как определяется значение по умолчанию. Явно определить TimeZone
экземпляр, см. toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar)
.
Поле Полевым Преобразованием от этого class до 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 |
get millisecond order from getFractionalSecond() * |
GregorianCalendar.setTimeZone(TimeZone) |
getTimezone() formatted into Custom timezone id |
To ensure consistency in conversion implementations, the new GregorianCalendar
should be instantiated in following manner.
timeZone
value as defined above, create a new java.util.GregorianCalendar(timeZone,Locale.getDefault())
. Calendar.clear()
.GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE))
.Calendar.set(int,int)
public abstract GregorianCalendar toGregorianCalendar(TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults)
Convert this XMLGregorianCalendar
along with provided parameters to a GregorianCalendar
instance.
Since XML Schema 1.0 date/time datetypes has no concept of timezone ids or daylight savings timezone ids, this conversion operation allows the user to explicitly specify one with timezone
parameter.
To compute the return value's TimeZone
field,
timeZone
is non-null, it is the timezone field.this.getTimezone() != FIELD_UNDEFINED
, create a java.util.TimeZone
with a custom timezone id using the this.getTimezone()
.defaults.getTimezone() != FIELD_UNDEFINED
, create a java.util.TimeZone
with a custom timezone id using defaults.getTimezone()
.GregorianCalendar
default timezone value for the host is defined as specified by java.util.TimeZone.getDefault()
.To ensure consistency in conversion implementations, the new GregorianCalendar
should be instantiated in following manner.
java.util.GregorianCalendar(TimeZone, Locale)
with TimeZone set as specified above and the Locale
parameter. Calendar.clear()
GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE))
.Calendar.set(int,int)
timezone
- provide Timezone. null
is a legal value.aLocale
- provide explicit Locale. Use default GregorianCalendar locale if value is null
.defaults
- provide default field values to use when corresponding field for this instance is FIELD_UNDEFINED or null. If defaults
is null
or a field within the specified defaults
is undefined, just use java.util.GregorianCalendar
defaults.public abstract TimeZone getTimeZone(int defaultZoneoffset)
Returns a java.util.TimeZone
for this class.
If timezone field is defined for this instance, returns TimeZone initialized with custom timezone id of zoneoffset. If timezone field is undefined, try the defaultZoneoffset that was passed in. If defaultZoneoffset is FIELD_UNDEFINED, return default timezone for this host. (Same default as java.util.GregorianCalendar).
defaultZoneoffset
- default zoneoffset if this zoneoffset is DatatypeConstants.FIELD_UNDEFINED
.
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92