ch.agent.t2.applied

Class SystemTime

java.lang.Object

ch.agent.t2.time.Time2

ch.agent.t2.applied.SystemTime

All Implemented Interfaces:

TimeIndex, Comparable<TimeIndex>

public class SystemTime
extends Time2

A SystemTime is a Time2 time with millisecond resolution and the origin at 1970-01-01. It corresponds to the time used internally by Date. For times before 1970-01-01, TimeIndex.asOffset() will return negative values. The domain label is systemtime.

Author:

Jean-Paul Vetterli

Field Summary

Fields

Modifier and Type	Field and Description
static TimeDomain	DOMAIN A constant holding the domain.
static String	LABEL A constant holding the domain label.

Constructor Summary

Constructors

Constructor and Description
SystemTime() Constructs the current time in the systemtime domain.
SystemTime(long millis) Construct a systemtime from a Java fast time.
SystemTime(long year, int month, int day, int hour, int min, int sec, int msec) Construct a systemtime time from the given time components.
SystemTime(String date) Construct a systemtime time from a string.
SystemTime(TimeIndex time) Construct a systemtime time from another time object.

Method Summary

Modifier and Type	Method and Description
long	asFastJavaTime() Get the fast Java time corresponding to this systemtime.

Methods inherited from class ch.agent.t2.time.Time2

add, asLong, asOffset, compareTo, convert, convert, equals, getDay, getDayByRank, getDayOfWeek, getFractionalSecond, getHour, getMinute, getMonth, getSecond, getTimeDomain, getYear, hashCode, sub, toString, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

LABEL

public static final String LABEL

A constant holding the domain label.

See Also:

Constant Field Values

DOMAIN

public static final TimeDomain DOMAIN

A constant holding the domain.

Constructor Detail

SystemTime

public SystemTime(TimeIndex time)
           throws T2Exception

Construct a systemtime time from another time object.

Parameters:

time - a non-null time in the domain systemtime

Throws:

T2Exception

SystemTime

public SystemTime()
           throws T2Exception

Constructs the current time in the systemtime domain.

Throws:

T2Exception

SystemTime

public SystemTime(long millis)

Construct a systemtime from a Java fast time. A Java fast time is returned for example by

 System.currentTimeMillis()
 

To get a Java fast time from a systemtime do

 SystemTime t;
 ...
 long javaTime = t - SystemTime.DOMAIN.getOrigin();
 

Parameters:

millis - a number of milliseconds since the epoch

SystemTime

public SystemTime(String date)
           throws T2Exception

Construct a systemtime time from a string.

Parameters:

date - a non-null string

Throws:

T2Exception

SystemTime

public SystemTime(long year,
                  int month,
                  int day,
                  int hour,
                  int min,
                  int sec,
                  int msec)
           throws T2Exception

Construct a systemtime time from the given time components.

Parameters:

year - a non-negative number

month - a number in [1-12]

day - a number between 1 and the last day of the month

hour - a number in [0-23]

min - a number in [0-59]

sec - a number in [0-59]

msec - a msec in [0-999]

Throws:

T2Exception

Method Detail

asFastJavaTime

public long asFastJavaTime()

Get the fast Java time corresponding to this systemtime. The result can be passed to the java.util.Date constructor.

Returns:

a long representing a fast Java time