Class TimeDuration

java.lang.Object

TimeDuration

public class TimeDuration
extends java.lang.Object

TimeDuration is an interval of time. The interval is in minutes and seconds (whole numbers). Intervals greater than 60 minutes do not "roll over" to hours.

Version:

9/2009

Author:

J. Dalbey

Constructor Summary

Constructors

Constructor and Description
TimeDuration(int initialSeconds) Construct a time duration with a given initial number of seconds.
TimeDuration(int initialMinutes, int initialSeconds) Construct a time duration with a given initial value for minutes and seconds.

Method Summary

Methods

Modifier and Type	Method and Description
TimeDuration	add(TimeDuration val) Returns a TimeDuration whose value is (this + val).
boolean	equals(java.lang.Object x) Compares this TimeDuration with the specified Object for equality.
int	minutes() Accessor to number of minutes.
int	seconds() Return duration as seconds.
TimeDuration	subtract(TimeDuration val) Returns a TimeDuration whose value is (this - val).
java.lang.String	toString() Return a displayable representation of this time interval.

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TimeDuration

public TimeDuration(int initialSeconds)

Construct a time duration with a given initial number of seconds.

Parameters:

initialSeconds - integer value of seconds

Precondition:

0 <= initialSeconds

TimeDuration

public TimeDuration(int initialMinutes,
            int initialSeconds)

Construct a time duration with a given initial value for minutes and seconds.

Parameters:

initialMinutes - integer value of minutes

initialSeconds - integer value of seconds

Precondition:

0 <= initialMinutes <= 999
, 0 <= initialSeconds <= 59

Method Detail

minutes

public int minutes()

Accessor to number of minutes.

Returns:

the minutes component of this TimeDuration

seconds

public int seconds()

Return duration as seconds.

Returns:

int duration as number of seconds.

add

public TimeDuration add(TimeDuration val)

Returns a TimeDuration whose value is (this + val).

Parameters:

val - value to be added to this TimeDuration.

Returns:

this + val

subtract

public TimeDuration subtract(TimeDuration val)

Returns a TimeDuration whose value is (this - val).

Parameters:

val - value to be subtracted from this TimeDuration.

Returns:

this - val

Throws:

java.lang.ArithmeticException - if result would be negative.

equals

public boolean equals(java.lang.Object x)

Compares this TimeDuration with the specified Object for equality.

Overrides:

equals in class java.lang.Object

Parameters:

x - Object to which this TimeDuration is to be compared.

Returns:

true if and only if the specified Object is a TimeDuration whose value is numerically equal to this TimeDuration.

toString

public java.lang.String toString()

Return a displayable representation of this time interval.

Overrides:

toString in class java.lang.Object

Returns:

the duration in a common "MM:SS" format. Examples:
0:55
1:23
11:42
0:06