This class enables you to process XML attributes or elements of type xs:duration.
Constructors
Name |
Description |
|
|---|---|---|
|
Duration(Duration newvalue) |
Initializes a new instance of the Duration class to the Duration object supplied as argument. |
|
Duration(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond, boolean newisnegative) |
Initializes a new instance of the Duration class to a duration built from parts supplied as arguments. |
Methods
Name |
Description |
|||||||
|---|---|---|---|---|---|---|---|---|
|
static Duration getFromDayTime( int newday, int newhour, int newminute, int newsecond, double newpartsecond ) |
Returns a Duration object created from the number of days, hours, minutes, seconds, and fractional second parts supplied as argument. |
||||||
|
static Duration getFromYearMonth( int newyear, int newmonth ) |
Returns a Duration object created from the number of years and months supplied as argument. |
||||||
|
static Duration parse( String s ) |
Returns a Duration object created from the string supplied as argument. For example, the string -P1Y1M1DT1H1M1.333S can be used to create a negative duration of one year, one month, one day, one hour, one minute, one second, and 0.333 fractional parts of a second. To create a negative duration, append the minus sign ( - ) to the string. |
||||||
|
static Duration parse( String s, ParseType pt ) |
Returns a Duration object created from the string supplied as argument, using a specific parse format. The parse format can be any of the following:
|
||||||
|
int getDay() |
Returns the number of days in the current Duration instance. |
||||||
|
long getDayTimeValue() |
Returns the day and time value (in milliseconds) of the current Duration instance. Years and months are ignored. |
||||||
|
int getHour() |
Returns the number of hours in the current Duration instance. |
||||||
|
int getMillisecond() |
Returns the number of milliseconds in the current Duration instance. |
||||||
|
int getMinute() |
Returns the number of minutes in the current Duration instance. |
||||||
|
int getMonth() |
Returns the number of months in the current Duration instance. |
||||||
|
double getPartSecond() |
Returns the number of fractional second parts in the current Duration instance. |
||||||
|
int getSecond() |
Returns the number of seconds in the current Duration instance. |
||||||
|
int getYear() |
Returns the number of years in the current Duration instance. |
||||||
|
int getYearMonthValue() |
Returns the year and month value (in months) of the current Duration instance. Days, hours, seconds, and milliseconds are ignored. |
||||||
|
boolean isNegative() |
Returns Boolean true if the current Duration instance is positive. |
||||||
|
void setDayTimeValue(long l) |
Sets the duration to the number of milliseconds supplied as argument, affecting only the day and time part of the duration. |
||||||
|
void setNegative( boolean isnegative ) |
Converts the current Duration instance to a negative duration. |
||||||
|
void setYearMonthValue(int l) |
Sets the duration to the number of months supplied as argument. Only the years and months part of the duration is affected. |
||||||
|
String toString() |
Returns the string representation of the current Duration instance, for example:
-P4DT4H4M4.774S |
||||||
|
String toYearMonthString() |
Returns the string representation of the YearMonth part of the current Duration instance, for example:
P1Y2M |
Examples
Before using the following code listings in your program, ensure the Altova types are imported:
import com.altova.types.*; import com.altova.types.Duration.ParseType; |
The following code listing illustrates various ways to create Duration objects:
protected static void ExampleDuration() { // Create a negative duration of 1 year, 1 month, 1 day, 1 hour, 1 minute, 1 second, // and 0.333 fractional second parts Duration dr = new Duration(1, 1, 1, 1, 1, 1, .333, true);
// Create a duration from an existing Duration object Duration dr1 = new Duration(dr);
// Create a duration of 4 days, 4 hours, 4 minutes, 4 seconds, .774 fractional second parts Duration dr2 = Duration.getFromDayTime(4, 4, 4, 4, .774);
// Create a duration of 3 years and 2 months Duration dr3 = Duration.getFromYearMonth(3, 2);
// Create a duration from a string Duration dr4 = Duration.parse("-P4DT4H4M4.774S");
// Create a duration from a string, using specific parse formats Duration dr5 = Duration.parse("-P1Y1M1DT1H1M1.333S", ParseType.DURATION); Duration dr6 = Duration.parse("P3Y2M", ParseType.YEARMONTH); Duration dr7 = Duration.parse("-P4DT4H4M4.774S", ParseType.DAYTIME); } |
The following code listing illustrates getting and setting the value of Duration objects:
protected static void DurationExample2() { // Create a duration of 1 year, 2 month, 3 days, 4 hours, 5 minutes, 6 seconds, // and 333 milliseconds Duration dr = new Duration(1, 2, 3, 4, 5, 6, .333, false); // Output the number of days in this duration System.out.println(dr.getDay());
// Create a positive duration of one year and 333 milliseconds Duration dr1 = new Duration(1, 0, 0, 0, 0, 0, .333, false); // Output the day and time value in milliseconds System.out.println(dr1.getDayTimeValue());
// Create a positive duration of 1 year, 1 month, 1 day, 1 hour, 1 minute, 1 second, // and 333 milliseconds Duration dr2 = new Duration(1, 1, 1, 1, 1, 1, .333, false); // Output the year and month value in months System.out.println(dr2.getYearMonthValue());
// Create a positive duration of 1 year and 1 month Duration dr3 = new Duration(1, 1, 0, 0, 0, 0, 0, false); // Output the value System.out.println("The duration is now: " + dr3.toString()); // Set the DayTime part of duration to 1000 milliseconds dr3.setDayTimeValue(1000); // Output the value System.out.println("The duration is now: " + dr3.toString()); // Set the YearMonth part of duration to 1 month dr3.setYearMonthValue(1); // Output the value System.out.println("The duration is now: " + dr3.toString()); // Output the year and month part of the duration System.out.println("The YearMonth part of the duration is: " + dr3.toYearMonthString()); } |
