public class DateTime extends Real
Internally, the object uses seconds since the epoch (1970-01-01 00:00:00Z) as the temporal reference.
System.currentTimeMillis(),
Serialized FormDataImpl.Syncher| Modifier and Type | Field and Description |
|---|---|
static String |
DEFAULT_TIME_FORMAT
Default Time Format Pattern (yyyy-MM-dd HH:mm:ss)
|
static TimeZone |
DEFAULT_TIMEZONE
Default Time Zone (GMT)
|
ABS, ACOS, ACOS_DEGREES, ADD, ASIN, ASIN_DEGREES, ATAN, ATAN_DEGREES, ATAN2, ATAN2_DEGREES, CEIL, COS, COS_DEGREES, DEGREES_TO_RADIANS, DEPENDENT, DIVIDE, EXP, FLOOR, INDEPENDENT, INV_ATAN2, INV_ATAN2_DEGREES, INV_DIVIDE, INV_POW, INV_REMAINDER, INV_SUBTRACT, LOG, MAX, MIN, MULTIPLY, NEAREST_NEIGHBOR, NEGATE, NO_ERRORS, NOP, POW, RADIANS_TO_DEGREES, REMAINDER, RINT, ROUND, SIN, SIN_DEGREES, SQRT, SUBTRACT, TAN, TAN_DEGREES, WEIGHTED_AVERAGE| Constructor and Description |
|---|
DateTime()
Construct a DateTime object and initialize it to the current date/time.
|
DateTime(Date date)
Construct a DateTime object and initialize it with a Java date.
|
DateTime(double seconds)
Construct a DateTime object and initialize it with the seconds since
January 1, 1970 00:00:00Z.
|
DateTime(double timeValue,
Unit timeUnits)
Construct a DateTime object from a tim value and a Unit
|
DateTime(int year,
int day,
double seconds)
Construct a DateTime object initialized with a year, day of
the year, and seconds in the day.
|
DateTime(Real real)
Construct a DateTime object and initialize it using a VisAD Real.
|
| Modifier and Type | Method and Description |
|---|---|
int |
compareTo(Object oo)
Implement Comparable interface
|
static DateTime |
createDateTime(String dateString)
Create a DateTime object from a string specification
|
static DateTime |
createDateTime(String dateString,
String format)
Create a DateTime object from a string specification using the
supplied pattern and default timezone.
|
static DateTime |
createDateTime(String dateString,
String format,
TimeZone timezone)
Create a DateTime object from a string specification using the
supplied pattern and timezone.
|
String |
dateString()
Return a string representing the "date" portion of this DateTime
|
String |
formattedString(String pattern,
TimeZone timezone)
Return a string representation of this DateTime from a user
specified format.
|
static Real |
fromYearDaySeconds(int year,
int day,
double seconds)
Return a Real object whose value is the seconds since the Epoch
initialized with a year, day of the year, and seconds in the day.
|
static String |
getFormatPattern()
Return the format pattern used in the output of the toString() method.
|
static TimeZone |
getFormatTimeZone()
Return the TimeZone used in the output of the toString() method.
|
Real |
getReal()
Get a Real representing the number of seconds since * the epoch.
|
static void |
main(String[] args)
run 'java visad.DateTime' to test the DateTime class
|
static Gridded1DDoubleSet |
makeTimeSet(DateTime[] times)
Create a Gridded1DDoubleSet from an array of DateTimes
|
static Gridded1DDoubleSet |
makeTimeSet(double[] times)
Create a Gridded1DDoubleSet from an array of doubles of seconds
since the epoch.
|
static void |
resetFormat()
Reset the format of the output of the toString() method to the default -
|
static void |
setDateFormatClass(Class dateFormatClass)
You can override the DateFormat by specifying a class.
|
static void |
setFormatPattern(String pattern)
Set the format of the output of the toString() method.
|
static void |
setFormatTimeZone(TimeZone tz)
Set the TimeZone of the output of the toString() method.
|
static DateTime[] |
timeSetToArray(Gridded1DSet timeSet)
Create an array of DateTimes from a Gridded1DSet of times.
|
String |
timeString()
Return a string representing the "time" portion of this DateTime
|
String |
toString()
Return a string representation of this DateTime.
|
String |
toValueString()
Gets a string that represents just the value portion of this
DateTime -- but with full semantics.
|
__eq__, __eq__, __ge__, __ge__, __gt__, __gt__, __le__, __le__, __lt__, __lt__, __ne__, __ne__, adjustSamplingError, binary, cloneButUnit, cloneButValue, computeRanges, equals, getError, getUnit, getValue, getValue, hashCode, isMissing, longString, unaryaddReference, clone, removeReference__add__, __add__, __div__, __div__, __mod__, __mod__, __mul__, __mul__, __neg__, __pow__, __pow__, __radd__, __rdiv__, __rmod__, __rmul__, __rpow__, __rsub__, __sub__, __sub__, abs, abs, acos, acos, acosDegrees, acosDegrees, add, add, asin, asin, asinDegrees, asinDegrees, atan, atan, atan2, atan2, atan2Degrees, atan2Degrees, atanDegrees, atanDegrees, binary, ceil, ceil, changeMathType, computeRanges, computeRanges, cos, cos, cosDegrees, cosDegrees, dataClone, divide, divide, exp, exp, floor, floor, getType, local, log, log, longString, max, max, min, min, multiply, multiply, negate, negate, notifyReferences, pow, pow, remainder, remainder, rint, rint, round, round, sin, sin, sinDegrees, sinDegrees, sqrt, sqrt, subtract, subtract, tan, tan, tanDegrees, tanDegrees, unaryfinalize, getClass, notify, notifyAll, wait, wait, waitabs, abs, acos, acos, acosDegrees, acosDegrees, add, add, asin, asin, asinDegrees, asinDegrees, atan, atan, atan2, atan2, atan2Degrees, atan2Degrees, atanDegrees, atanDegrees, binary, ceil, ceil, changeMathType, computeRanges, computeRanges, cos, cos, cosDegrees, cosDegrees, dataClone, divide, divide, exp, exp, floor, floor, getType, local, log, log, longString, max, max, min, min, multiply, multiply, negate, negate, pow, pow, remainder, remainder, rint, rint, round, round, sin, sin, sinDegrees, sinDegrees, sqrt, sqrt, subtract, subtract, tan, tan, tanDegrees, tanDegrees, unaryaddReference, removeReferencepublic static final String DEFAULT_TIME_FORMAT
public static final TimeZone DEFAULT_TIMEZONE
public DateTime(Real real) throws VisADException
real - Real value in a temporal unit.VisADException - unit conversion problempublic DateTime(double seconds)
throws VisADException
seconds - number of seconds since 1970-01-01 00:00:00Z.VisADException - unit conversion problempublic DateTime(double timeValue,
Unit timeUnits)
throws VisADException
timeValue - value of time in timeUnitstimeUnits - units of valueVisADExceptionpublic DateTime(Date date) throws VisADException
date - date objectVisADException - unit conversion problempublic DateTime()
throws VisADException
VisADException - unit conversion problempublic DateTime(int year,
int day,
double seconds)
throws VisADException
year - year - use negative year to indicated BCday - day of the yearseconds - seconds in the dayVisADException - invalid day or seconds. Days must be
greater than zero and seconds must be greater
than zero and less than or equal to the
seconds in a day.public static Real fromYearDaySeconds(int year, int day, double seconds) throws VisADException
year - year - use negative year to indicated BCday - day of the yearseconds - seconds in the dayVisADException - invalid day or seconds. Days must be
greater than zero and seconds must be greater
than zero and less than or equal to the
seconds in a day.public Real getReal()
public String toString()
toString in interface RealIfacetoString in class RealsetFormatPattern(java.lang.String),
setFormatTimeZone(java.util.TimeZone)public String toValueString()
toValueString in interface RealIfacetoValueString in class Realpublic String formattedString(String pattern, TimeZone timezone)
pattern - time format stringtimezone - time zone to useSimpleDateFormat,
TimeZonepublic String dateString()
public String timeString()
public static void setDateFormatClass(Class dateFormatClass)
dateFormatClass - The class. This must be derived from java.text.DateFormatpublic static void setFormatPattern(String pattern)
pattern - time format stringIf you want to use a time zone other than the default,,
setFormatTimeZone(java.util.TimeZone)public static String getFormatPattern()
SimpleDateFormatpublic static void setFormatTimeZone(TimeZone tz)
tz - time zoneTimeZonepublic static TimeZone getFormatTimeZone()
public static void resetFormat()
public static DateTime createDateTime(String dateString) throws VisADException
dateString - date string specification in format pattern
defined for DateTime in this JVMVisADException - formatting problemsetFormatPattern(java.lang.String)public static DateTime createDateTime(String dateString, String format) throws VisADException
dateString - date string specificationformat - stringVisADException - formatting problempublic static DateTime createDateTime(String dateString, String format, TimeZone timezone) throws VisADException
dateString - date string specificationformat - format stringtimezone - TimeZone to useVisADException - formatting problempublic int compareTo(Object oo)
compareTo in interface ComparablecompareTo in interface RealIfacecompareTo in class Realoo - Object for comparison - should be DateTime
ErrorEstimate.compareTo() method is used
to break the tie.public static Gridded1DDoubleSet makeTimeSet(DateTime[] times) throws VisADException
times - array of DateTimes. Array cannot be null or only
have one entry.VisADException - couldn't create the GriddedDoubleSetpublic static Gridded1DDoubleSet makeTimeSet(double[] times) throws VisADException
times - array of times in seconds since the epoch. Array
cannot be null or only have one entry.VisADException - couldn't create the GriddedDoubleSetpublic static DateTime[] timeSetToArray(Gridded1DSet timeSet) throws VisADException
timeSet - Gridded1DSet of timesVisADException - invalid time set or couldn't create DateTimespublic static void main(String[] args) throws VisADException
VisADException