org.apache.uima.internal.util
Class TimeSpan

java.lang.Object
  extended by org.apache.uima.internal.util.TimeSpan

public class TimeSpan
extends java.lang.Object

Encode a span of time. The main purpose of this class is to provide a printing utility for time spans. E.g., 1081 ms should be printed as 1.081 s, 108101 ms should be printed as 1 min 48.101 s, etc.

Note that the largest value you can represent with this class is 9223372036854775807 (Long.MAX_VALUE), or equivalently, 292471208 yrs 247 days 7 hrs 12 min 55.807 sec. Overflow is not handled gracefully by this class.

Also note that for the purposes of this class, a year has 365 days. I.e., a year corresponds to 365 * 24 * 60 * 60 * 1000 ms.


Constructor Summary
TimeSpan()
          Create an uninstantiated TimeSpan.
TimeSpan(long milliseconds)
          Create a TimeSpan from a ms interval.
 
Method Summary
 int getDays()
          Get the day fraction of this object.
 long getFullMilliseconds()
          Get the length of the TimeSpan as milliseconds.
 int getHours()
          Get the hour fraction of this object.
 int getMilliseconds()
          Get the millisecond fraction of this object.
 int getMinutes()
          Get the minute fraction of this object.
 int getSeconds()
          Get the second fraction of this object.
 int getYears()
          Get the year fraction of this object.
 boolean isInstantiated()
           
 boolean setDays(int days)
          Set the day fraction of this TimeSpan.
 boolean setFullMilliseconds(long milliseconds)
          Set the full TimeSpan in terms of milliseconds.
 boolean setHours(int hours)
          Set the hour fraction of this TimeSpan.
 boolean setMilliseconds(int milliseconds)
          Set the millisecond fraction of this TimeSpan.
 boolean setMinutes(int minutes)
          Set the minute fraction of this TimeSpan.
 boolean setSeconds(int seconds)
          Set the second fraction of this TimeSpan.
 boolean setYears(int years)
          Set the year fraction of this TimeSpan.
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TimeSpan

public TimeSpan()
Create an uninstantiated TimeSpan.


TimeSpan

public TimeSpan(long milliseconds)
Create a TimeSpan from a ms interval.

Parameters:
milliseconds - The interval in ms. If milliseconds < 0, an uninstantiated TimeSpan is created.
Method Detail

isInstantiated

public boolean isInstantiated()
Returns:
true, if the object has been instantiated with a legal interval; false, else.

setYears

public boolean setYears(int years)
Set the year fraction of this TimeSpan.

Parameters:
years - The number of years.
Returns:
false, if years < 0; true, else.

setDays

public boolean setDays(int days)
Set the day fraction of this TimeSpan.

Parameters:
days - The number of days.
Returns:
false, if days < 0; true, else.

setHours

public boolean setHours(int hours)
Set the hour fraction of this TimeSpan.

Parameters:
hours - The number of hours.
Returns:
false, if hours < 0; true, else.

setMinutes

public boolean setMinutes(int minutes)
Set the minute fraction of this TimeSpan.

Parameters:
minutes - The number of minutes.
Returns:
false, if minutes < 0; true, else.

setSeconds

public boolean setSeconds(int seconds)
Set the second fraction of this TimeSpan.

Parameters:
seconds - The number of seconds.
Returns:
false, if seconds < 0; true, else.

setMilliseconds

public boolean setMilliseconds(int milliseconds)
Set the millisecond fraction of this TimeSpan.

Parameters:
milliseconds - The number of milliseconds.
Returns:
false, if milliseconds < 0; true, else.

setFullMilliseconds

public boolean setFullMilliseconds(long milliseconds)
Set the full TimeSpan in terms of milliseconds.

Parameters:
milliseconds - The number of milliseconds.
Returns:
false, if milliseconds < 0; true, else.

getFullMilliseconds

public long getFullMilliseconds()
Get the length of the TimeSpan as milliseconds.

Returns:
The number of milliseconds, if known. -1, else (e.g., when the TimeSpan is not instantiated).

getYears

public int getYears()
Get the year fraction of this object.

Returns:
-1, if this object is not instantiated; the year fraction, else.

getDays

public int getDays()
Get the day fraction of this object.

Returns:
-1, if this object is not instantiated; the day fraction, else.

getHours

public int getHours()
Get the hour fraction of this object.

Returns:
-1, if this object is not instantiated; the hour fraction, else.

getMinutes

public int getMinutes()
Get the minute fraction of this object.

Returns:
-1, if this object is not instantiated; the minute fraction, else.

getSeconds

public int getSeconds()
Get the second fraction of this object.

Returns:
-1, if this object is not instantiated; the second fraction, else.

getMilliseconds

public int getMilliseconds()
Get the millisecond fraction of this object.

Returns:
-1, if this object is not instantiated; the millisecond fraction, else.

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object
Returns:
String representation of object. See class comments.


Copyright © 2013. All Rights Reserved.