Microsoft SDK for Java

Time.add

Creates a new Time object that represents the number of time units (100 nanoseconds) after the time that this Time object represents. 

Syntax

public Time add( long interval )

Parameters

interval

An integer value that represents the number of time units (100 nanoseconds) to add to the current time.

Return Value

Returns a Time object that represents the new time.

Remarks

Time objects cannot be altered. Use the add method to create a new Time object whose date and time is based on the current Time object but incremented by the number of time units specified in interval.

The following example illustrates how to use the add method to create a new Time object that is two hours later in time than a Time object that is initialized to the current time:

public void AddTwoHours()
{
   //Create object that is set to current time
   Time now = new Time();
   //Output the current time
   System.out.println("The current time is: " + now.toString());
   
   //Increment the current time by two hours
   Time twoHoursLater = now.add(Time.UNITS_PER_HOUR * 2);
   //Output the time
   System.out.println("The time two hours from now is: " + twoHoursLater.toString());
}

See Also   Time.UNITS_PER_HOUR

© 1999 Microsoft Corporation. All rights reserved. Terms of use.