OpenJDK 27 · com.sun.org.apache.xerces.internal.jaxp.datatype.DurationYearMonthImpl

Modifier and Type	Field and Description
private static final long	serialVersionUID Hides com.sun.org.apache.xerces.internal.jaxp.datatype.DurationImpl.serialVersionUID.

Constructor Summary

Access	Constructor and Description
public	DurationYearMonthImpl(boolean Set to `false` to create a negative duration. When the length of the duration is zero, this parameter will be ignored. isPositive, BigInteger of this `Duration` years, BigInteger of this `Duration` months) Constructs a new Duration object by specifying each field individually.
protected	DurationYearMonthImpl(final boolean Set to `false` to create a negative duration. When the length of the duration is zero, this parameter will be ignored. isPositive, final int years, final int months) Construct a `Duration` of type `xdt:yearMonthDuration` using the specified `year` and `month` as defined in XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.
protected	DurationYearMonthImpl(long Milliseconds of `Duration` to create. durationInMilliseconds) Construct a `Duration` of type `xdt:yearMonthDuration` using the specified milliseconds as defined in XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.
protected	DurationYearMonthImpl(String Lexical representation of a duration. lexicalRepresentation) Construct a `Duration` of type `xdt:yearMonthDuration` by parsing its `String` representation, "PnYnM", XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.

Modifier and Type	Method and Description
private void	convertToCanonicalYearMonth()
public int	Returns: the value of yearMonthDuration getValue() The value space of xs:yearMonthDuration is the set of xs:integer month values.

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.sun.org.apache.xerces.internal.jaxp.datatype.DurationImpl.serialVersionUID.

Constructor Detail

DurationYearMonthImpl back to summary

DurationYearMonthImpl	back to summary
public DurationYearMonthImpl(boolean isPositive, BigInteger years, BigInteger months) Constructs a new Duration object by specifying each field individually. All the parameters are optional as long as at least one field is present. If specified, parameters have to be zero or positive. Parameters isPositive:boolean Set to `false` to create a negative duration. When the length of the duration is zero, this parameter will be ignored. years:BigInteger of this `Duration` months:BigInteger of this `Duration` Exceptions IllegalArgumentException: If years, months parameters are all `null`. Or if any of those parameters are negative.

public DurationYearMonthImpl(boolean isPositive, BigInteger years, BigInteger months)

Constructs a new Duration object by specifying each field individually.

All the parameters are optional as long as at least one field is present. If specified, parameters have to be zero or positive.

Parameters

isPositive:boolean: Set to false to create a negative duration. When the length of the duration is zero, this parameter will be ignored.
years:BigInteger: of this Duration
months:BigInteger: of this Duration

Exceptions

IllegalArgumentException:: If years, months parameters are all null. Or if any of those parameters are negative.

DurationYearMonthImpl back to summary

DurationYearMonthImpl	back to summary
protected DurationYearMonthImpl(final boolean isPositive, final int years, final int months) Construct a `Duration` of type `xdt:yearMonthDuration` using the specified `year` and `month` as defined in XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration. A `DatatypeConstants#FIELD_UNDEFINED` value indicates that field is not set. Parameters isPositive:boolean Set to `false` to create a negative duration. When the length of the duration is zero, this parameter will be ignored. Exceptions IllegalArgumentException: If the values are not a valid representation of a `Duration`: if any of the fields (year, month) is negative.

protected DurationYearMonthImpl(final boolean isPositive, final int years, final int months)

Construct a Duration of type xdt:yearMonthDuration using the specified year and month as defined in XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.

A DatatypeConstants#FIELD_UNDEFINED value indicates that field is not set.

Parameters

isPositive:boolean: Set to false to create a negative duration. When the length of the duration is zero, this parameter will be ignored.

Exceptions

IllegalArgumentException:: If the values are not a valid representation of a Duration: if any of the fields (year, month) is negative.

DurationYearMonthImpl back to summary

DurationYearMonthImpl	back to summary
protected DurationYearMonthImpl(long durationInMilliseconds) Construct a `Duration` of type `xdt:yearMonthDuration` using the specified milliseconds as defined in XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration. The datatype `xdt:yearMonthDuration` is a subtype of `xs:duration` whose lexical representation contains only year and month components. This datatype resides in the namespace `javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI`. Both values are set by computing their values from the specified milliseconds and are availabe using the `get` methods of the created `Duration`. The values conform to and are defined by: ISO 8601:2000(E) Section 5.5.3.2 Alternative format W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats `XMLGregorianCalendar` Date/Time Datatype Field Mapping Between XML Schema 1.0 and Java Representation The default start instance is defined by `GregorianCalendar`'s use of the start of the epoch: i.e., `java.util.Calendar#YEAR` = 1970, `java.util.Calendar#MONTH` = `java.util.Calendar#JANUARY`, `java.util.Calendar#DATE` = 1, etc. This is important as there are variations in the Gregorian Calendar, e.g. leap years have different days in the month = `java.util.Calendar#FEBRUARY` so the result of `Duration#getMonths()` can be influenced. Any remaining milliseconds after determining the year and month are discarded. Parameters durationInMilliseconds:long Milliseconds of `Duration` to create.

protected DurationYearMonthImpl(long durationInMilliseconds)

Construct a Duration of type xdt:yearMonthDuration using the specified milliseconds as defined in XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.

The datatype xdt:yearMonthDuration is a subtype of xs:duration whose lexical representation contains only year and month components. This datatype resides in the namespace javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI.

Both values are set by computing their values from the specified milliseconds and are availabe using the get methods of the created Duration. The values conform to and are defined by:

ISO 8601:2000(E) Section 5.5.3.2 Alternative format
W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats
XMLGregorianCalendar Date/Time Datatype Field Mapping Between XML Schema 1.0 and Java Representation

The default start instance is defined by GregorianCalendar's use of the start of the epoch: i.e., java.util.Calendar#YEAR = 1970, java.util.Calendar#MONTH = java.util.Calendar#JANUARY, java.util.Calendar#DATE = 1, etc. This is important as there are variations in the Gregorian Calendar, e.g. leap years have different days in the month = java.util.Calendar#FEBRUARY so the result of Duration#getMonths() can be influenced.

Any remaining milliseconds after determining the year and month are discarded.

Parameters

durationInMilliseconds:long: Milliseconds of Duration to create.

DurationYearMonthImpl back to summary

DurationYearMonthImpl	back to summary
protected DurationYearMonthImpl(String lexicalRepresentation) Construct a `Duration` of type `xdt:yearMonthDuration` by parsing its `String` representation, "PnYnM", XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration. The datatype `xdt:yearMonthDuration` is a subtype of `xs:duration` whose lexical representation contains only year and month components. This datatype resides in the namespace `javax.xml.XMLConstants#W3C_XPATH_DATATYPE_NS_URI`. Both values are set and availabe from the created `Duration` The XML Schema specification states that values can be of an arbitrary size. Implementations may chose not to or be incapable of supporting arbitrarily large and/or small values. An `UnsupportedOperationException` will be thrown with a message indicating implementation limits if implementation capacities are exceeded. Parameters lexicalRepresentation:String Lexical representation of a duration. Exceptions IllegalArgumentException: If `lexicalRepresentation` is not a valid representation of a `Duration` expressed only in terms of years and months. UnsupportedOperationException: If implementation cannot support requested values. NullPointerException: If `lexicalRepresentation` is `null`.

protected DurationYearMonthImpl(String lexicalRepresentation)

Construct a Duration of type xdt:yearMonthDuration by parsing its String representation, "PnYnM", XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration.

Both values are set and availabe from the created Duration

The XML Schema specification states that values can be of an arbitrary size. Implementations may chose not to or be incapable of supporting arbitrarily large and/or small values. An UnsupportedOperationException will be thrown with a message indicating implementation limits if implementation capacities are exceeded.

Parameters

lexicalRepresentation:String: Lexical representation of a duration.

Exceptions

IllegalArgumentException:: If lexicalRepresentation is not a valid representation of a Duration expressed only in terms of years and months.
UnsupportedOperationException:: If implementation cannot support requested values.
NullPointerException:: If lexicalRepresentation is null.

pack-priv Class DurationYearMonthImpl

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail