Класс 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 для обработки 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", как определено в 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 и 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 и XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(long durationInMilliseconds)`	Создать `Duration` типа `xdt:dayTimeDuration`, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationDayTime(String lexicalRepresentation)`	Создать `Duration` типа `xdt:dayTimeDuration`, анализируя его `String` представление, "PnDTnHnMnS", XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.
`Duration`	`newDurationYearMonth(boolean isPositive, int year, int month)`	Создать `Duration` типа `xdt:yearMonthDuration`, используя указанные `year` и `month`, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(boolean isPositive, BigInteger year, BigInteger month)`	Создать `Duration` типа `xdt:yearMonthDuration`, используя указанные `year` и `month`, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(long durationInMilliseconds)`	Создать `Duration` типа `xdt:yearMonthDuration`, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
`Duration`	`newDurationYearMonth(String lexicalRepresentation)`	Создать `Duration` типа `xdt:yearMonthDuration`, анализируя его `String` представление, "PnYnM", XQuery 1.0 и 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 встроенной реализации по умолчанию системы.

Возвращает:: Новый экземпляр встроенной реализации по умолчанию системы.
С тех пор:: 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 по имени класса. Эта функция полезна, когда в классе пути есть несколько поставщиков. Она предоставляет больше контроля приложению, так как оно может указать, какой поставщик должен быть загружен.

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

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

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

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

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

Параметры:

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

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

Возвращает:

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

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

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

С тех пор:

1.6

См. также:

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

Значение 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, years, months, days, hours, minutes, seconds.

Значение 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:

newDurationDayTime

public Duration newDurationDayTime(String lexicalRepresentation)

Создать Duration типа xdt:dayTimeDuration, разобрав его строковое представление, "PnDTnHnMnS", XQuery 1.0 and 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 and XPath 2.0 Data Model, xdt:dayTimeDuration.

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

ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
W3C XML Schema 1.0 Part 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:

newDurationDayTime

public 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.

Значение 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 с сообщением, указывающим на ограничения реализации, если пределы ёмкости реализации будут превышены.

Параметры:: 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 Сопоставление полей типа данных даты/времени между XML Schema 1.0 и представлением Java

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

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

Параметры:: 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)`^*

*потеря информации при преобразовании. Невозможно представить идентификатор часового пояса с летним временем в представлении типа данных даты/времени 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)

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

Например, экземпляр 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)

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

Значение 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)

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

Значение 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)

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

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

Параметры:

hours - число часов

minutes - число минут

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

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

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

Возвращает:

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

Исключения:

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

См. также:

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