Класс 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", как определено в 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 Модель данных, 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`, анализируя его строковое представление "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`, анализируя его строковое представление "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)`	Создать 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

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 используется для загрузки класса фабрики.

Возвращает:

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

Исключения:

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

С момента:

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 как:

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

продолжительность представляет длительность времени. Пространство значений продолжительности — это шестимерное пространство, где координаты обозначают компоненты года, месяца, дня, часа, минуты и секунды григорианского календаря, определённые в разделе 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, заданного параметрами 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 путем парсинга его строкового представления, "PnDTnHnMnS", XQuery 1.0 и XPath 2.0 Модель данных, xdt:dayTimeDuration.

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

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

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

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

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

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

Параметры:

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, проанализировав его строковое представление "PnYnM", XQuery 1.0 и XPath 2.0 Data Model, 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 Data Model, 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 Data Model, 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 errata, Раздел 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)

Создать 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 время.

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

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

Параметры:

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

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

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

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

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

Возвращает:

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

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

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

См. также:

© 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/datatype/DatatypeFactory.html