Inheritance diagram for org.omg.dds.core.ModifiableTime:

Collaboration diagram for org.omg.dds.core.ModifiableTime:

Public Member Functions
abstract void	add (Duration duration)
	Increment this time by the given amount. More...

abstract void	add (long duration, TimeUnit unit)
	Increment this time by the given amount. More...

abstract void	copyFrom (Time src)
	Overwrite the state of this object with that of the given object. More...

ServiceEnvironment	getEnvironment ()

abstract long	getRemainder (TimeUnit primaryUnit, TimeUnit remainderUnit)
	If getting the magnitude of this time in the given `primaryUnit` would cause truncation with respect to the given `remainderUnit`, return the magnitude of the truncation in the latter (presumably finer-grained) unit. More...

abstract long	getTime (TimeUnit inThisUnit)
	Truncate this time to a whole-number quantity of the given time unit. More...

abstract Time	immutableCopy ()

abstract boolean	isValid ()

abstract ModifiableTime	modifiableCopy ()

abstract void	setTime (long time, TimeUnit unit)

abstract void	subtract (Duration duration)
	Decrement this time by the given amount. More...

abstract void	subtract (long duration, TimeUnit unit)
	Decrement this time by the given amount. More...

Static Public Member Functions
static Time	invalidTime (ServiceEnvironment env)

static ModifiableTime	newTime (long time, TimeUnit units, ServiceEnvironment env)
	Construct a specific instant in time. More...

Detailed Description

Definition at line 24 of file ModifiableTime.java.

Member Function Documentation

◆ add() [1/2]

abstract void org.omg.dds.core.ModifiableTime.add ( Duration duration )

abstract

Increment this time by the given amount.

◆ add() [2/2]

abstract void org.omg.dds.core.ModifiableTime.add	(	long	duration,
		TimeUnit	unit
	)

abstract

Increment this time by the given amount.

◆ copyFrom()

abstract void org.omg.dds.core.ModifiableTime.copyFrom ( Time src )

abstract

Overwrite the state of this object with that of the given object.

◆ getEnvironment()

ServiceEnvironment org.omg.dds.core.DDSObject.getEnvironment ( )

inherited

Returns: the org.omg.dds.core.ServiceEnvironment object that directly or indirectly was used to create this object.

◆ getRemainder()

abstract long org.omg.dds.core.Time.getRemainder	(	TimeUnit	primaryUnit,
		TimeUnit	remainderUnit
	)

abstractinherited

If getting the magnitude of this time in the given primaryUnit would cause truncation with respect to the given remainderUnit, return the magnitude of the truncation in the latter (presumably finer-grained) unit.

For example, if this time is equal to one second plus 100 nanoseconds since the start of the epoch, calling this method with arguments of TimeUnit#SECONDS and TimeUnit#NANOSECONDS respectively will result in the value 100.

This method is equivalent to the following pseudo-code:

(this - getTime(primaryUnit)).getTime(remainderUnit)

If remainderUnit is represents a coarser granularity than primaryUnit (for example, the former is TimeUnit#MILLISECONDS but the latter is TimeUnit#SECONDS), this method shall return 0.

If the resulting time cannot be expressed in the given units without overflowing, this method shall return Long#MAX_VALUE.

Parameters

primaryUnit
remainderUnit	The time unit in which the return result will be measured.

See also: getTime(TimeUnit); Long::MAX_VALUE; TimeUnit

◆ getTime()

abstract long org.omg.dds.core.Time.getTime ( TimeUnit inThisUnit )

abstractinherited

Truncate this time to a whole-number quantity of the given time unit.

For example, if this time is equal to one second plus 100 nanoseconds since the start of the epoch, calling this method with an argument of TimeUnit#SECONDS will result in the value 1.

If this time is invalid, this method shall return a negative value, regardless of the units given.

If this time cannot be expressed in the given units without overflowing, this method shall return Long#MAX_VALUE. In such a case, the caller may wish to use this method in combination with getRemainder(TimeUnit, TimeUnit) to obtain the full time without lack of precision.

Parameters

inThisUnit The time unit in which the return result will be measured.

See also: getRemainder(TimeUnit, TimeUnit); Long::MAX_VALUE; TimeUnit

◆ immutableCopy()

abstract Time org.omg.dds.core.ModifiableTime.immutableCopy ( )

abstract

Returns: an immutable copy of this object's state.

◆ invalidTime()

static Time org.omg.dds.core.Time.invalidTime ( ServiceEnvironment env )

staticinherited

Parameters

env	Identifies the Service instance to which the object will belong.

Returns: An unmodifiable org.omg.dds.core.Time that is not valid.

Definition at line 81 of file Time.java.

◆ isValid()

abstract boolean org.omg.dds.core.Time.isValid ( )

abstractinherited

Returns: whether this time represents a meaningful instant in time.

◆ modifiableCopy()

abstract ModifiableTime org.omg.dds.core.Time.modifiableCopy ( )

abstractinherited

Returns: a modifiable copy of this object's state.

◆ newTime()

static ModifiableTime org.omg.dds.core.Time.newTime	(	long	time,
		TimeUnit	units,
		ServiceEnvironment	env
	)

staticinherited

Construct a specific instant in time.

Negative values are considered invalid and will result in the construction of a time t such that:

t.isValid() == false

Parameters

env	Identifies the Service instance to which the new object will belong.

See also: isValid()

Definition at line 62 of file Time.java.

◆ setTime()

abstract void org.omg.dds.core.ModifiableTime.setTime	(	long	time,
		TimeUnit	unit
	)

abstract

◆ subtract() [1/2]

abstract void org.omg.dds.core.ModifiableTime.subtract ( Duration duration )

abstract

Decrement this time by the given amount.

◆ subtract() [2/2]

abstract void org.omg.dds.core.ModifiableTime.subtract	(	long	duration,
		TimeUnit	unit
	)

abstract

Decrement this time by the given amount.

The documentation for this class was generated from the following file:

java5/common/java/code/org/omg/dds/core/ModifiableTime.java

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ add() [1/2]

◆ add() [2/2]

◆ copyFrom()

◆ getEnvironment()

◆ getRemainder()

◆ getTime()

◆ immutableCopy()

◆ invalidTime()

◆ isValid()

◆ modifiableCopy()

◆ newTime()

◆ setTime()

◆ subtract() [1/2]

◆ subtract() [2/2]