Класс DatatypeFactory

java.lang.Object

javax.xml.datatype.DatatypeFactory

public abstract class DatatypeFactory extends Object

Фабрика, создающая новые javax.xml.datatype Objects, которые сопоставляют XML с Java Objects.

Новый экземпляр DatatypeFactory создается через метод newInstance(), который использует механизм поиска JAXP для определения класса реализации DatatypeFactory для загрузки.

С момента:: 1.5

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`DATATYPEFACTORY_IMPLEMENTATION_CLASS`	Имя класса реализации по умолчанию, как определено в JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.
`static final String`	`DATATYPEFACTORY_PROPERTY`	Имя свойства по умолчанию, как определено в JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.

Краткое описание конструкторов

DatatypeFactory()

Модификатор	Конструктор	Описание
`protected`	Защищенный конструктор для предотвращения создания экземпляров вне пакета.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static DatatypeFactory`	`newDefaultInstance()`	Создает новый экземпляр `DatatypeFactory` встроенной реализации по умолчанию системы.
`Duration`	`newDuration(boolean isPositive, int years, int months, int days, int hours, int minutes, int seconds)`	Получает новый экземпляр `Duration`, указав `Duration` как isPositive, years, months, days, hours, minutes, seconds.
`abstract Duration`	`newDuration(boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)`	Получает новый экземпляр `Duration`, указав `Duration` как isPositive, years, months, days, hours, minutes, seconds.
`abstract Duration`	`newDuration(long durationInMilliSeconds)`	Получает новый экземпляр `Duration`, указав `Duration` как миллисекунды.
`abstract Duration`	`newDuration(String lexicalRepresentation)`	Получает новый экземпляр `Duration`, указав `Duration` как его строковое представление, "PnYnMnDTnHnMnS", как определено в XML Schema 1.0 раздел 3.2.6.1.
`Duration`	`newDurationDayTime(boolean isPositive, int day, int hour, int minute, int second)`	Создает `Duration` типа `xdt:dayTimeDuration`, используя указанные `day`, `hour`, `minute` и `second`, как определено в XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(boolean isPositive, BigInteger day, BigInteger hour, BigInteger minute, BigInteger second)`	Создает `Duration` типа `xdt:dayTimeDuration`, используя указанные `day`, `hour`, `minute` и `second`, как определено в XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(long durationInMilliseconds)`	Создает `Duration` типа `xdt:dayTimeDuration`, используя указанные миллисекунды, как определено в XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(String lexicalRepresentation)`	Создает `Duration` типа `xdt:dayTimeDuration`, анализируя его `String` представление, "PnDTnHnMnS", XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationYearMonth(boolean isPositive, int year, int month)`	Создает `Duration` типа `xdt:yearMonthDuration`, используя указанные `year` и `month`, как определено в XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(boolean isPositive, BigInteger year, BigInteger month)`	Создает `Duration` типа `xdt:yearMonthDuration`, используя указанные `year` и `month`, как определено в XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(long durationInMilliseconds)`	Создает `Duration` типа `xdt:yearMonthDuration`, используя указанные миллисекунды, как определено в XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(String lexicalRepresentation)`	Создает `Duration` типа `xdt:yearMonthDuration`, анализируя его `String` представление, "PnYnM", XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.
`static DatatypeFactory`	`newInstance()`	Получает новый экземпляр `DatatypeFactory`.
`static DatatypeFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)`	Получает новый экземпляр `DatatypeFactory` по имени класса.
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar()`	Создает новый экземпляр `XMLGregorianCalendar`.
`XMLGregorianCalendar`	`newXMLGregorianCalendar(int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone)`	Конструктор пространств значений, которые экземпляр `java.util.GregorianCalendar` должен будет преобразовать в экземпляр `XMLGregorianCalendar`.
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(String lexicalRepresentation)`	Создает новый XMLGregorianCalendar, анализируя строку как лексическое представление.
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone)`	Конструктор, допускающий полные пространства значений, разрешенные рекомендацией W3C XML Schema 1.0 для xsd:dateTime и связанных встроенных типов данных.
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(GregorianCalendar cal)`	Создает `XMLGregorianCalendar` из `GregorianCalendar`.
`XMLGregorianCalendar`	`newXMLGregorianCalendarDate(int year, int month, int day, int timezone)`	Создает Java-представление встроенного типа данных XML Schema `date` или `g*`.
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int timezone)`	Создает Java-экземпляр встроенного типа данных XML Schema `time`.
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int milliseconds, int timezone)`	Создает Java-экземпляр встроенного типа данных XML Schema time.
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)`	Создает Java-экземпляр встроенного типа данных XML Schema time.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

DATATYPEFACTORY_PROPERTY

public static final String DATATYPEFACTORY_PROPERTY

Стандартное имя свойства, определенное в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.

Значение по умолчанию — javax.xml.datatype.DatatypeFactory.

См. также:

Значения константных полей

DATATYPEFACTORY_IMPLEMENTATION_CLASS

public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS

Стандартное имя класса реализации, определенное в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.

Реализаторы должны указать имя подходящего класса для инстанцирования, если другие механизмы разрешения реализации не увенчались успехом.

Пользователи не должны ссылаться на это поле; оно предназначено только для документирования детали реализации фабрики.

Подробное описание конструкторов

DatatypeFactory

protected DatatypeFactory()

Защищенный конструктор для предотвращения инстанцирования вне пакета.

Используйте newInstance() для создания DatatypeFactory.

Подробное описание методов

newDefaultInstance

public static DatatypeFactory newDefaultInstance()

Создает новый экземпляр DatatypeFactory встроенной реализации по умолчанию системы.

Возвращает:: Новый экземпляр DatatypeFactory встроенной реализации по умолчанию системы.
С:: 9

newInstance

public static DatatypeFactory newInstance() throws DatatypeConfigurationException

Получить новый экземпляр DatatypeFactory. Этот метод использует механизм поиска JAXP для определения DatatypeFactory класса реализации для загрузки.

Возвращает:

Новый экземпляр DatatypeFactory

Исключение:

DatatypeConfigurationException - Если реализация недоступна или не может быть инстанцирована.

См. также:

newInstance(String factoryClassName, ClassLoader classLoader)

newInstance

public static DatatypeFactory newInstance(String factoryClassName, ClassLoader classLoader) throws DatatypeConfigurationException

Получить новый экземпляр DatatypeFactory по имени класса. Эта функция полезна, когда в пути класса присутствует несколько поставщиков. Она предоставляет больше контроля приложению, так как оно может указать, какой поставщик должен быть загружен.

После того, как приложение получило ссылку на DatatypeFactory, оно может использовать фабрику для настройки и получения экземпляров типов данных.

Совет по устранению неполадок

Установка свойства системы jaxp.debug приведет к тому, что этот метод будет выводить много сообщений отладки в System.err о том, что он делает и где он ищет.

Если у вас возникли проблемы, попробуйте:

 java -Djaxp.debug=1 YourProgram ....

Параметры:

factoryClassName - полное имя класса фабрики, предоставляющей реализацию javax.xml.datatype.DatatypeFactory.

classLoader - ClassLoader для загрузки класса фабрики. Если null текущий Thread контекст classLoader используется для загрузки класса фабрики.

Возвращает:

Новый экземпляр DatatypeFactory

Исключение:

DatatypeConfigurationException - если factoryClassName null, или класс фабрики не может быть загружен или инстанцирован.

С:

1.6

См. также:

newInstance()

newDuration

public abstract Duration newDuration(String lexicalRepresentation)

Получить новый экземпляр Duration, задавая Duration в виде строкового представления "PnYnMnDTnHnMnS", как определено в XML Schema 1.0 разделе 3.2.6.1.

Часть 2 XML Schema: Типы данных, 3.2.6 duration, определяет duration как:

duration представляет продолжительность времени. Пространство значений duration — шестимерное пространство, где координаты обозначают компоненты григорианского года, месяца, дня, часа, минуты и секунды, определенные в разделе 5.5.3.2 [ISO 8601], соответственно. Эти компоненты упорядочены по значению по порядку появления, то есть как год, месяц, день, час, минута и секунда.

Все шесть значений установлены и доступны из созданного Duration

Спецификация XML Schema указывает, что значения могут быть произвольного размера. Реализации могут выбрать не поддерживать произвольно большие и/или малые значения или быть неспособны это сделать. UnsupportedOperationException будет брошен с сообщением, указывающим пределы реализации, если емкость реализации превышена.

Параметры:: lexicalRepresentation - String представление Duration.
Возвращает:: Новый Duration созданный из парсинга lexicalRepresentation.
Исключение:: IllegalArgumentException - Если lexicalRepresentation не является допустимым представлением Duration.; UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.; NullPointerException - если lexicalRepresentation null.

newDuration

public abstract Duration newDuration(long durationInMilliSeconds)

Получить новый экземпляр Duration, задавая Duration в миллисекундах.

Часть 2 XML Schema: Типы данных, 3.2.6 duration, определяет duration как:

duration представляет продолжительность времени. Пространство значений duration — шестимерное пространство, где координаты обозначают компоненты григорианского года, месяца, дня, часа, минуты и секунды, определенные в разделе 5.5.3.2 [ISO 8601], соответственно. Эти компоненты упорядочены по значению по порядку появления, то есть как год, месяц, день, час, минута и секунда.

Все шесть значений устанавливаются путем вычисления их значений из заданных миллисекунд и доступны с использованием методов get созданного Duration. Значения соответствуют и определены:

ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
W3C XML Schema 1.0 Часть 2, Приложение D, Форматы дат и времени ISO 8601
XMLGregorianCalendar Сопоставление полей типов данных даты/времени между XML Schema 1.0 и Java-представлением

Значение по умолчанию начального экземпляра определено использованием GregorianCalendar началом эпохи: т.е. Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 и т.д. Это важно, так как есть вариации в григорианском календаре, например, високосные годы имеют разные дни в месяце = Calendar.FEBRUARY, поэтому результат Duration.getMonths() и Duration.getDays() может быть повлиян.

Параметры:: durationInMilliSeconds - Продолжительность в миллисекундах для создания.
Возвращает:: Новый Duration представляющий durationInMilliSeconds.

newDuration

public abstract Duration newDuration(boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

Получить новый экземпляр Duration задавая Duration как isPositive, years, months, days, hours, minutes, seconds.

Значение null указывает, что поле не установлено.

Параметры:: isPositive - Установите в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр будет проигнорирован.; years - of this Duration; months - of this Duration; days - of this Duration; hours - of this Duration; minutes - of this Duration; seconds - of this Duration
Возвращает:: Новый Duration созданный из заданных значений.
Исключение:: IllegalArgumentException - Если значения не являются допустимым представлением Duration: если все поля (years, months, ...) равны null или если какое-либо из полей отрицательно.; UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.

newDuration

public Duration newDuration(boolean isPositive, int years, int months, int days, int hours, int minutes, int seconds)

Получить новый экземпляр Duration, задавая Duration как isPositive, года, месяца, дни, часы, минуты, секунды.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Parameters:

isPositive - Установить в false, чтобы создать отрицательную продолжительность. Когда продолжительность равна нулю, этот параметр игнорируется.

years - данной Duration

months - данной Duration

days - данной Duration

hours - данной Duration

minutes - данной Duration

seconds - данной Duration

Returns:

Новый Duration, созданный из указанных значений.

Throws:

IllegalArgumentException - Если значения не являются допустимым представлением Duration: если любое из полей отрицательно.

See Also:

newDuration(boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

newDurationDayTime

public Duration newDurationDayTime(String lexicalRepresentation)

Создать Duration типа xdt:dayTimeDuration, проанализировав его строковое представление "PnDTnHnMnS", XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.

Тип данных xdt:dayTimeDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты дня, часа, минуты и секунды. Этот тип данных находится в пространстве имён http://www.w3.org/2003/11/xpath-datatypes.

Все четыре значения установлены и доступны из созданного Duration

Спецификация XML Schema утверждает, что значения могут быть произвольного размера. Реализации могут отказаться от поддержки или не быть способны поддерживать произвольно большие и/или малые значения. Будет выброшено исключение UnsupportedOperationException с сообщением об ограничениях реализации, если емкости реализации будут превышены.

Parameters:: lexicalRepresentation - Лексическое представление продолжительности.
Returns:: Новый Duration, созданный с использованием указанного lexicalRepresentation.
Throws:: IllegalArgumentException - Если lexicalRepresentation не является допустимым представлением Duration, выраженным только в терминах дней и времени.; UnsupportedOperationException - Если реализация не может поддержать запрошенные значения.; NullPointerException - Если lexicalRepresentation является null.

newDurationDayTime

public Duration newDurationDayTime(long durationInMilliseconds)

Создать Duration типа xdt:dayTimeDuration, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.

Все четыре значения устанавливаются, вычисляя их значения из указанных миллисекунд, и доступны с помощью методов get созданного Duration. Значения соответствуют и определяются:

ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
W3C XML Schema 1.0 Часть 2, Приложение D, Форматы дат и времени ISO 8601
XMLGregorianCalendar Сопоставление полей типов данных даты/времени между XML Schema 1.0 и представлением Java

Значение по умолчанию для начала определяется использованием GregorianCalendar начала эпохи: т.е. Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 и т.д. Это важно, так как существуют вариации в Григорианском календаре, например, високосные годы имеют разные дни в месяце = Calendar.FEBRUARY, поэтому результат Duration.getDays() может быть повлиян.

Любые оставшиеся миллисекунды после определения дня, часа, минуты и секунды отбрасываются.

Parameters:

durationInMilliseconds - Миллисекунды Duration для создания.

Returns:

Новый Duration, созданный с указанными durationInMilliseconds.

See Also:

XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration

newDurationDayTime

public Duration newDurationDayTime(boolean isPositive, BigInteger day, BigInteger hour, BigInteger minute, BigInteger second)

Создать Duration типа xdt:dayTimeDuration, используя указанные day, hour, minute и second, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.

Значение null указывает, что поле не задано.

Parameters:: isPositive - Установить в false, чтобы создать отрицательную продолжительность. Когда продолжительность равна нулю, этот параметр игнорируется.; day - День Duration.; hour - Час Duration.; minute - Минута Duration.; second - Секунда Duration.
Returns:: Новый Duration, созданный с указанными day, hour, minute и second.
Throws:: IllegalArgumentException - Если значения не являются допустимым представлением Duration: если все поля (день, час, ...) равны null или если любое из полей отрицательно.; UnsupportedOperationException - Если реализация не может поддержать запрошенные значения.

newDurationDayTime

public Duration newDurationDayTime(boolean isPositive, int day, int hour, int minute, int second)

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Parameters:: isPositive - Установить в false, чтобы создать отрицательную продолжительность. Когда продолжительность равна нулю, этот параметр игнорируется.; day - День Duration.; hour - Час Duration.; minute - Минута Duration.; second - Секунда Duration.
Returns:: Новый Duration, созданный с указанными day, hour, minute и second.
Throws:: IllegalArgumentException - Если значения не являются допустимым представлением Duration: если любое из полей (день, час, ...) отрицательно.

newDurationYearMonth

public Duration newDurationYearMonth(String lexicalRepresentation)

Создать Duration типа xdt:yearMonthDuration, разобрав его строковое представление, "PnYnM", XQuery 1.0 и XPath 2.0 Модель данных, xdt:yearMonthDuration.

Тип данных xdt:yearMonthDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты года и месяца. Этот тип данных находится в пространстве имён XMLConstants.W3C_XPATH_DATATYPE_NS_URI.

Оба значения устанавливаются и доступны в созданном Duration

Спецификация XML Schema утверждает, что значения могут иметь произвольный размер. Реализации могут выбрать не поддерживать или неспособны поддерживать произвольно большие и/или малые значения. UnsupportedOperationException будет брошен с сообщением, указывающим на ограничения реализации, если возможности реализации будут превышены.

Parameters:: lexicalRepresentation - Лексическое представление продолжительности.
Returns:: Новый Duration созданный с указанным lexicalRepresentation.
Throws:: IllegalArgumentException - Если lexicalRepresentation не является допустимым представлением Duration, выраженного только в терминах лет и месяцев.; UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.; NullPointerException - Если lexicalRepresentation является null.

newDurationYearMonth

public Duration newDurationYearMonth(long durationInMilliseconds)

Создать Duration типа xdt:yearMonthDuration, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Модель данных, xdt:yearMonthDuration.

Оба значения устанавливаются, вычисляя их из указанных миллисекунд, и доступны с помощью методов get созданного Duration. Значения соответствуют и определены:

ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
W3C XML Schema 1.0 Часть 2, Приложение D, Форматы дат и времени ISO 8601
XMLGregorianCalendar Сопоставление полей типа данных даты/времени между XML Schema 1.0 и представлением Java

Значение начала по умолчанию определяется использованием началом эпохи в GregorianCalendar: т.е., Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 и т.д. Это важно, так как существуют различия в Григорианском календаре, например, високосные годы имеют разные дни в месяце = Calendar.FEBRUARY, поэтому результат Duration.getMonths() может быть повлияно.

Любые оставшиеся миллисекунды после определения года и месяца отбрасываются.

Parameters:: durationInMilliseconds - Миллисекунды Duration для создания.
Returns:: Новый Duration созданный с указанными durationInMilliseconds.

newDurationYearMonth

public Duration newDurationYearMonth(boolean isPositive, BigInteger year, BigInteger month)

Создать Duration типа xdt:yearMonthDuration, используя указанные year и month, как определено в XQuery 1.0 и XPath 2.0 Модель данных, xdt:yearMonthDuration.

Значение null указывает, что поле не установлено.

Parameters:: isPositive - Установлено в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр игнорируется.; year - Год Duration.; month - Месяц Duration.
Returns:: Новый Duration созданный с указанными year и month.
Throws:: IllegalArgumentException - Если значения не являются допустимым представлением Duration: если все поля (год, месяц) равны null или если любое из полей отрицательно.; UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.

newDurationYearMonth

public Duration newDurationYearMonth(boolean isPositive, int year, int month)

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Parameters:: isPositive - Установлено в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр игнорируется.; year - Год Duration.; month - Месяц Duration.
Returns:: Новый Duration созданный с указанными year и month.
Throws:: IllegalArgumentException - Если значения не являются допустимым представлением Duration: если любое из полей (год, месяц) отрицательно.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar()

Создать новый экземпляр XMLGregorianCalendar.

Все поля типа данных даты/времени установлены в DatatypeConstants.FIELD_UNDEFINED или null.

Returns:: Новый XMLGregorianCalendar со всеми полями типа данных даты/времени, установленными в DatatypeConstants.FIELD_UNDEFINED или null.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(String lexicalRepresentation)

Создать новый XMLGregorianCalendar, разобрав строку как лексическое представление.

Разбор лексического строкового представления определён в XML Schema 1.0 Часть 2, Раздел 3.2.[7-14].1, Лексическое представление.

Строковое представление не должно иметь начальных и конечных пробелов.

Разбор выполняется поле за полем, так что для любой лексически корректной строки x справедливо:

 newXMLGregorianCalendar(x).toXMLFormat().equals(x)

За исключением отмеченных несоответствий лексического/канонического представления, перечисленных в XML Schema 1.0 исправления, Раздел 3.2.7.2.

Parameters:: lexicalRepresentation - Лексическое представление одного из восьми типов данных даты/времени XML Schema.
Returns:: XMLGregorianCalendar созданный из lexicalRepresentation.
Throws:: IllegalArgumentException - Если lexicalRepresentation не является допустимым XMLGregorianCalendar.; NullPointerException - Если lexicalRepresentation является null.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(GregorianCalendar cal)

Создать XMLGregorianCalendar из GregorianCalendar.

Преобразование полей из `GregorianCalendar` в `XMLGregorianCalendar`
`java.util.GregorianCalendar` поле	`javax.xml.datatype.XMLGregorianCalendar` поле
`ERA == GregorianCalendar.BC ? -YEAR : YEAR`	`XMLGregorianCalendar.setYear(int year)`
`MONTH + 1`	`XMLGregorianCalendar.setMonth(int month)`
`DAY_OF_MONTH`	`XMLGregorianCalendar.setDay(int day)`
`HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND`	`XMLGregorianCalendar.setTime(int hour, int minute, int second, BigDecimal fractional)`
`(ZONE_OFFSET + DST_OFFSET) / (601000)` (в минутах)*	`XMLGregorianCalendar.setTimezone(int offset)`^*

*потеря информации при преобразовании. Невозможно представить идентификатор часового пояса летнего времени java.util.GregorianCalendar в представлении типа данных даты/времени XML Schema 1.0.

Для вычисления поля TimeZone возвращаемого значения,

если this.getTimezone() != FIELD_UNDEFINED, создайте java.util.TimeZone с пользовательским идентификатором часового пояса, используя this.getTimezone().
в противном случае используйте значение по умолчанию часового пояса GregorianCalendar для хоста, определенное в соответствии со спецификацией java.util.TimeZone.getDefault().

Parameters:: cal - java.util.GregorianCalendar для создания XMLGregorianCalendar
Returns:: XMLGregorianCalendar созданный из java.util.GregorianCalendar
Throws:: NullPointerException - Если cal является null.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone)

Конструктор, позволяющий использовать все значения, разрешенные рекомендацией W3C XML Schema 1.0 для xsd:dateTime и связанных встроенных типов данных. Обратите внимание, что параметр year поддерживает произвольно большие числа, а fractionalSecond имеет бесконечную точность.

Значение null указывает, что поле не установлено.

Parameters:: year - значение XMLGregorianCalendar для создания.; month - значение XMLGregorianCalendar для создания.; day - значение XMLGregorianCalendar для создания.; hour - значение XMLGregorianCalendar для создания.; minute - значение XMLGregorianCalendar для создания.; second - значение XMLGregorianCalendar для создания.; fractionalSecond - значение XMLGregorianCalendar для создания.; timezone - значение XMLGregorianCalendar для создания.
Returns:: XMLGregorianCalendar созданный из указанных значений.
Throws:: IllegalArgumentException - Если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют некорректный экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().

newXMLGregorianCalendar

public XMLGregorianCalendar newXMLGregorianCalendar(int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone)

Конструктор для диапазона значений, который экземпляр java.util.GregorianCalendar должен преобразовать в экземпляр XMLGregorianCalendar.

XMLGregorianCalendar eon и fractionalSecond установлены в null

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Parameters:: year - значение XMLGregorianCalendar для создания.; month - значение XMLGregorianCalendar для создания.; day - значение XMLGregorianCalendar для создания.; hour - значение XMLGregorianCalendar для создания.; minute - значение XMLGregorianCalendar для создания.; second - значение XMLGregorianCalendar для создания.; millisecond - значение XMLGregorianCalendar для создания.; timezone - значение XMLGregorianCalendar для создания.
Returns:: XMLGregorianCalendar созданный из указанных значений.
Throws:: IllegalArgumentException - Если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют некорректный экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().

newXMLGregorianCalendarDate

public XMLGregorianCalendar newXMLGregorianCalendarDate(int year, int month, int day, int timezone)

Создать Java-представление встроенного типа данных XML Schema date или g*.

Например, экземпляр gYear можно создать, вызвав этот фабричный метод с параметрами month и day, установленных в DatatypeConstants.FIELD_UNDEFINED.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Parameters:

year - значение XMLGregorianCalendar для создания.

month - значение XMLGregorianCalendar для создания.

day - значение XMLGregorianCalendar для создания.

timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не установлено.

Returns:

XMLGregorianCalendar созданный из значений параметров.

Throws:

IllegalArgumentException - Если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют некорректный экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().

See Also:

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int timezone)

Создать Java-экземпляр встроенного типа данных XML Schema time.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Parameters:

hours - количество часов

minutes - количество минут

seconds - количество секунд

timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не установлено.

Returns:

XMLGregorianCalendar созданный из значений параметров.

Throws:

See Also:

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)

Создать Java-экземпляр встроенного типа данных XML Schema time.

Значение null указывает, что поле не установлено.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Parameters:

hours - количество часов

minutes - количество минут

seconds - количество секунд

fractionalSecond - значение null указывает, что это необязательное поле не установлено.

timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не установлено.

Returns:

XMLGregorianCalendar созданный из значений параметров.

Throws:

See Also:

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int milliseconds, int timezone)

Создать экземпляр Java типа времени XML Schema встроенного типа данных.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Параметры:

hours - количество часов

minutes - количество минут

seconds - количество секунд

milliseconds - количество миллисекунд

timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не задано.

Возвращает:

XMLGregorianCalendar созданный из значений параметров.

Исключения:

IllegalArgumentException - Если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют недопустимый экземпляр XMLGregorianCalendar как определено в XMLGregorianCalendar.isValid().

См. также:

DatatypeConstants.FIELD_UNDEFINED

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.xml/javax/xml/datatype/DatatypeFactory.html