Класс DatatypeFactory

java.lang.Object

javax.xml.datatype.DatatypeFactory

public abstract class DatatypeFactory extends Object

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

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

Начиная с:: 1.5

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

Модификатор и тип	Поле	Описание
`static final String`	`DATATYPEFACTORY_IMPLEMENTATION_CLASS`	Имя класса реализации по умолчанию, определенное в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.
`static final String`	`DATATYPEFACTORY_PROPERTY`	Имя свойства по умолчанию, определенное в JSR 206: Java(TM) API для обработки XML (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", определенного в разделе 3.2.6.1 XML Schema 1.0.
`Duration`	`newDurationDayTime(boolean isPositive, int day, int hour, int minute, int second)`	Создает `Duration` типа `xdt:dayTimeDuration`, используя указанные `day`, `hour`, `minute` и `second`, как определено в модели данных XQuery 1.0 и XPath 2.0, xdt:dayTimeDuration.
`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, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(long durationInMilliseconds)`	Создает `Duration` типа `xdt:dayTimeDuration`, используя указанные миллисекунды, как определено в модели данных XQuery 1.0 и XPath 2.0, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(String lexicalRepresentation)`	Создает `Duration` типа `xdt:dayTimeDuration`, разбирая его `String` представление "PnDTnHnMnS", модель данных XQuery 1.0 и XPath 2.0, xdt:dayTimeDuration.
`Duration`	`newDurationYearMonth(boolean isPositive, int year, int month)`	Создает `Duration` типа `xdt:yearMonthDuration`, используя указанные `year` и `month`, как определено в модели данных XQuery 1.0 и XPath 2.0, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(boolean isPositive, BigInteger year, BigInteger month)`	Создает `Duration` типа `xdt:yearMonthDuration`, используя указанные `year` и `month`, как определено в модели данных XQuery 1.0 и XPath 2.0, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(long durationInMilliseconds)`	Создает `Duration` типа `xdt:yearMonthDuration`, используя указанные миллисекунды, как определено в модели данных XQuery 1.0 и XPath 2.0, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(String lexicalRepresentation)`	Создает `Duration` типа `xdt:yearMonthDuration`, разбирая его `String` представление "PnYnM", модель данных XQuery 1.0 и XPath 2.0, 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)`	Создает представление встроенного типа данных XML Schema `date` или `g*` на Java.
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int timezone)`	Создает экземпляр встроенного типа данных XML Schema `time` на Java.
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int milliseconds, int timezone)`	Создает экземпляр встроенного типа данных XML Schema time на Java.
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)`	Создает экземпляр встроенного типа данных XML Schema time на Java.

Методы, объявленные в классе 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 for XML Processing (JAXP) 1.3.

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

См. также:

DATATYPEFACTORY_IMPLEMENTATION_CLASS

public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS

Имя класса реализации по умолчанию, определённое в JSR 206: Java(TM) API for XML Processing (JAXP) 1.3.

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

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

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

DatatypeFactory

protected DatatypeFactory()

Защищённый конструктор, предотвращающий создание экземпляров за пределами пакета.

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

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

newDefaultInstance

public static DatatypeFactory newDefaultInstance()

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

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

newInstance

public static DatatypeFactory newInstance() throws DatatypeConfigurationException

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

Возвращает:

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

Выбрасывает:

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

См. также:

newInstance

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

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

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

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

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

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

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

Параметры:

factoryClassName — полное имя класса фабрики, реализующего javax.xml.datatype.DatatypeFactory.

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

Возвращает:

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

Выбрасывает:

DatatypeConfigurationException — если factoryClassName равен null или класс фабрики не удаётся загрузить либо создать.

Начиная с:

1.6

См. также:

newDuration

public abstract Duration newDuration(String lexicalRepresentation)

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

В разделе 3.2.6 «duration» XML Schema Part 2: Datatypes 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 в миллисекундах.

В разделе 3.2.6 «duration» XML Schema Part 2: Datatypes 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 Сопоставление полей типа данных даты/времени с представлением Java в XML Schema 1.0

Начальный экземпляр по умолчанию определяется использованием 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, годы, месяцы, дни, часы, минуты и секунды.

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

Параметры:: isPositive — установите в false, чтобы создать отрицательную длительность. Если длительность равна нулю, этот параметр игнорируется.; years — Duration; months — Duration; days — Duration; hours — Duration; minutes — Duration; seconds — Duration
Возвращает:: Новый Duration, созданный из заданных значений.
Выбрасывает:: IllegalArgumentException — если значения не являются допустимым представлением Duration: если все поля (годы, месяцы и т. д.) равны 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 указывает, что поле не задано.

Параметры:

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

years — Duration

months — Duration

days — Duration

hours — Duration

minutes — Duration

seconds — Duration

Возвращает:

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

Выбрасывает:

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

См. также:

newDurationDayTime

public Duration newDurationDayTime(String lexicalRepresentation)

Создаёт Duration типа xdt:dayTimeDuration, разбирая его String представление «PnDTnHnMnS» из модели данных XQuery 1.0 и XPath 2.0, xdt:dayTimeDuration.

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

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

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

newDurationDayTime

public Duration newDurationDayTime(long durationInMilliseconds)

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

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

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

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

Параметры:

durationInMilliseconds — количество миллисекунд Duration, которое нужно создать.

Возвращает:

Новый Duration, созданный с использованием заданного durationInMilliseconds.

См. также:

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, xdt:dayTimeDuration.

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

Параметры:: isPositive — установите в false, чтобы создать отрицательную длительность. Если длительность равна нулю, этот параметр игнорируется.; day — день Duration.; hour — час Duration.; minute — минута Duration.; second — секунда Duration.
Возвращает:: Новый Duration, созданный с использованием заданных day, hour, minute и second.
Выбрасывает:: IllegalArgumentException — если значения не являются допустимым представлением Duration: если все поля (день, час и т. д.) равны null или любое из полей отрицательно.; UnsupportedOperationException — если реализация не может поддерживать запрошенные значения.

newDurationDayTime

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

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

Параметры:: isPositive — установите в false, чтобы создать отрицательную длительность. Если длительность равна нулю, этот параметр игнорируется.; day — день Duration.; hour — час Duration.; minute — минута Duration.; second — секунда Duration.
Возвращает:: Новый Duration, созданный с использованием заданных day, hour, minute и second.
Выбрасывает:: IllegalArgumentException — если значения не являются допустимым представлением Duration: если любое из полей (день, час и т. д.) отрицательно.

newDurationYearMonth

public Duration newDurationYearMonth(String lexicalRepresentation)

Создаёт Duration типа xdt:yearMonthDuration, разбирая его String представление «PnYnM» из модели данных XQuery 1.0 и XPath 2.0, xdt:yearMonthDuration.

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

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

Параметры:: lexicalRepresentation — лексическое представление длительности.
Возвращает:: Новый Duration, созданный с использованием заданного lexicalRepresentation.
Выбрасывает:: 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 Сопоставление полей типа данных даты/времени с представлением Java в XML Schema 1.0

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

Параметры:: durationInMilliseconds — количество миллисекунд Duration, которое нужно создать.
Возвращает:: Новый 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 указывает, что поле не задано.

Параметры:: isPositive — установите в false, чтобы создать отрицательную длительность. Если длительность равна нулю, этот параметр игнорируется.; year — год Duration.; month — месяц Duration.
Возвращает:: Новый Duration, созданный с использованием заданных year и month.
Выбрасывает:: IllegalArgumentException — если значения не являются допустимым представлением Duration: если все поля (год, месяц) равны null или любое из полей отрицательно.; UnsupportedOperationException — если реализация не может поддерживать запрошенные значения.

newDurationYearMonth

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

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

Параметры:: isPositive — установите в false, чтобы создать отрицательную длительность. Если длительность равна нулю, этот параметр игнорируется.; year — год Duration.; month — месяц Duration.
Возвращает:: Новый Duration, созданный с использованием заданных year и month.
Выбрасывает:: IllegalArgumentException — если значения не являются допустимым представлением Duration: если любое из полей (год, месяц) отрицательно.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar()

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

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

Возвращает:: Новый 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.

Параметры:: lexicalRepresentation — лексическое представление одного из восьми типов данных даты/времени XML Schema.
Возвращает:: XMLGregorianCalendar, созданный из lexicalRepresentation.
Выбрасывает:: 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().

Параметры:: cal - java.util.GregorianCalendar, используемый для создания XMLGregorianCalendar
Возвращает:: XMLGregorianCalendar, созданный из java.util.GregorianCalendar
Вызывает исключение:: 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 указывает, что поле не задано.

Параметры:: year - значение XMLGregorianCalendar для создания.; month - значение XMLGregorianCalendar для создания.; day - значение XMLGregorianCalendar для создания.; hour - значение XMLGregorianCalendar для создания.; minute - значение XMLGregorianCalendar для создания.; second - значение XMLGregorianCalendar для создания.; fractionalSecond - значение XMLGregorianCalendar для создания.; timezone - значение XMLGregorianCalendar для создания.
Возвращает:: XMLGregorianCalendar, созданный из указанных значений.
Вызывает исключение:: 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 указывает, что поле не задано.

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

newXMLGregorianCalendarDate

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

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

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

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

Параметры:

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

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

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

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

Возвращает:

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

Вызывает исключение:

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

См. также:

newXMLGregorianCalendarTime

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

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

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

Параметры:

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

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

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

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

Возвращает:

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

Вызывает исключение:

См. также:

newXMLGregorianCalendarTime

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

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

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

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

Параметры:

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

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

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

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

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

Возвращает:

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

Вызывает исключение:

См. также:

newXMLGregorianCalendarTime

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

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

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

Параметры:

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

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

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

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

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

Возвращает:

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

Вызывает исключение:

См. также:

© 1993, 2025, 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/25/docs/api/java.xml/javax/xml/datatype/DatatypeFactory.html