org.jacorb.util
Class Time
public
class
Time
extends Object
Contains static methods to handle CORBA time values.
Version: $Id: Time.java,v 1.10 2006/07/07 10:57:59 alphonse.bendt Exp $
Author: Andre Spiegel
Field Summary |
static long | UNIX_OFFSET
Difference between the CORBA Epoch and the Unix Epoch: the time
from 1582/10/15 00:00 until 1970/01/01 00:00 in 100 ns units. |
Method Summary |
static UtcT | corbaFuture(long corbaUnits)
Returns a CORBA UtcT that represents an instant that lies
a given number of CORBA time units (100 ns) in the future.
|
static UtcT | corbaTime()
Returns the current time as a CORBA UtcT. |
static UtcT | corbaTime(long unixTime)
Converts the given unixTime into a CORBA UtcT. |
static UtcT | corbaTime(Date date)
Converts the given Java date into a CORBA UtcT. |
static UtcT | earliest(UtcT timeA, UtcT timeB)
Compares two UtcT time values and returns that which is earlier.
|
static UtcT | fromCDR(byte[] buffer)
Decodes a CDR encapsulation of a UtcT. |
static boolean | hasPassed(UtcT time)
Returns true if the instant represented by the given UtcT is
already in the past, false otherwise. |
static long | millisTo(UtcT time)
Returns the number of milliseconds between now and the given CORBA
time. |
static byte[] | toCDR(UtcT time)
Returns a CDR encapsulation of the given UtcT. |
static void | waitFor(UtcT time)
This method blocks until the given time has been reached.
|
public static final long UNIX_OFFSET
Difference between the CORBA Epoch and the Unix Epoch: the time
from 1582/10/15 00:00 until 1970/01/01 00:00 in 100 ns units.
public static UtcT corbaFuture(long corbaUnits)
Returns a CORBA UtcT that represents an instant that lies
a given number of CORBA time units (100 ns) in the future.
If the argument is negative, returns null.
public static UtcT corbaTime()
Returns the current time as a CORBA UtcT.
public static UtcT corbaTime(long unixTime)
Converts the given unixTime into a CORBA UtcT.
Parameters: unixTime the number of milliseconds since 1970/01/01 00:00 UTC.
public static UtcT corbaTime(Date date)
Converts the given Java date into a CORBA UtcT.
public static UtcT earliest(UtcT timeA, UtcT timeB)
Compares two UtcT time values and returns that which is earlier.
Either argument can be null; this is considered as a time that
lies indefinitely in the future. If both arguments are null,
this method returns null itself.
public static UtcT fromCDR(byte[] buffer)
Decodes a CDR encapsulation of a UtcT.
public static boolean hasPassed(UtcT time)
Returns true if the instant represented by the given UtcT is
already in the past, false otherwise. As a special convenience,
this method also returns false if the argument is null.
public static long millisTo(UtcT time)
Returns the number of milliseconds between now and the given CORBA
time. The value is positive if that time is in the future, and
negative otherwise.
public static byte[] toCDR(UtcT time)
Returns a CDR encapsulation of the given UtcT.
public static void waitFor(UtcT time)
This method blocks until the given time has been reached.
If the time is null, or it has already passed,
then this method returns immediately.