|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.hackystat.utilities.tstamp.Tstamp
public final class Tstamp
Utility class that facilitates Timestamp representation and processing. There are too many classes already named "Timestamp", thus the abbreviated name.
Method Summary | |
---|---|
static int |
daysBetween(javax.xml.datatype.XMLGregorianCalendar day1,
javax.xml.datatype.XMLGregorianCalendar day2)
Returns the number of days between time1 and time2. |
static long |
diff(javax.xml.datatype.XMLGregorianCalendar time1,
javax.xml.datatype.XMLGregorianCalendar time2)
Returns differences between time1 and time2 in milliseconds. |
static boolean |
equal(javax.xml.datatype.XMLGregorianCalendar time1,
javax.xml.datatype.XMLGregorianCalendar time2)
Returns true if time1 equals time2. |
static javax.xml.datatype.XMLGregorianCalendar |
getDefaultProjectEndTime()
Returns the end time for the Default project, which is five years after today. |
static javax.xml.datatype.XMLGregorianCalendar |
getDefaultProjectStartTime()
Returns the start time for the Default project, which is 2000-01-01. |
static boolean |
greaterThan(java.lang.String timeString1,
java.lang.String timeString2)
Returns true if timeString1 > timeString2. |
static boolean |
greaterThan(javax.xml.datatype.XMLGregorianCalendar time1,
javax.xml.datatype.XMLGregorianCalendar time2)
Returns true if time1 > time2. |
static boolean |
inBetween(javax.xml.datatype.XMLGregorianCalendar start,
javax.xml.datatype.XMLGregorianCalendar tstamp,
javax.xml.datatype.XMLGregorianCalendar end)
Returns true if tstamp is equal to or between start and end. |
static javax.xml.datatype.XMLGregorianCalendar |
incrementDays(javax.xml.datatype.XMLGregorianCalendar tstamp,
int days)
Returns a new XMLGregorianCalendar corresponding to the passed tstamp incremented by the number of days. |
static javax.xml.datatype.XMLGregorianCalendar |
incrementHours(javax.xml.datatype.XMLGregorianCalendar tstamp,
int hours)
Returns a new XMLGregorianCalendar corresponding to the passed tstamp incremented by the number of hours. |
static javax.xml.datatype.XMLGregorianCalendar |
incrementMilliseconds(javax.xml.datatype.XMLGregorianCalendar tstamp,
long milliseconds)
Returns a new XMLGregorianCalendar corresponding to the passed tstamp incremented by the number of milliseconds. |
static javax.xml.datatype.XMLGregorianCalendar |
incrementMinutes(javax.xml.datatype.XMLGregorianCalendar tstamp,
int minutes)
Returns a new XMLGregorianCalendar corresponding to the passed tstamp incremented by the number of minutes. |
static javax.xml.datatype.XMLGregorianCalendar |
incrementSeconds(javax.xml.datatype.XMLGregorianCalendar tstamp,
int seconds)
Returns a new XMLGregorianCalendar corresponding to the passed tstamp incremented by the number of seconds. |
static boolean |
isBogusStartTime(javax.xml.datatype.XMLGregorianCalendar startTime)
In the early days of Hackystat, default project start times were 1000-01-01. |
static boolean |
isTimestamp(java.lang.String lexicalRepresentation)
Returns true if the passed string can be parsed into an XMLGregorianCalendar object. |
static boolean |
isTodayOrLater(javax.xml.datatype.XMLGregorianCalendar timestamp)
Returns true if the passed timestamp indicates some time today or some time in the future. |
static boolean |
isYesterdayOrLater(javax.xml.datatype.XMLGregorianCalendar timestamp)
Returns true if the passed timestamp indicates some time yesterday or some time in the future. |
static boolean |
lessThan(javax.xml.datatype.XMLGregorianCalendar time1,
javax.xml.datatype.XMLGregorianCalendar time2)
Returns true if time1 < time2. |
static javax.xml.datatype.XMLGregorianCalendar |
makeTimestamp()
Returns an XMLGregorianCalendar corresponding to the current time. |
static javax.xml.datatype.XMLGregorianCalendar |
makeTimestamp(Day day)
Converts the specified Day into a javax.xml.datatype.XMLGregorianCalendar. |
static javax.xml.datatype.XMLGregorianCalendar |
makeTimestamp(long timeInMillis)
Converts the specified time in milliseconds into a javax.xml.datatype.XMLGregorianCalendar. |
static javax.xml.datatype.XMLGregorianCalendar |
makeTimestamp(java.lang.String rep)
Returns an XMLGregorianCalendar, given its string representation. |
static javax.xml.datatype.XMLGregorianCalendar |
makeTimestamp(java.sql.Timestamp tstamp)
Converts a javax.sql.Timestamp into a javax.xml.datatype.XMLGregorianCalendar. |
static java.sql.Timestamp |
makeTimestamp(javax.xml.datatype.XMLGregorianCalendar calendar)
Returns a new java.sql.Timestamp created from a javax.xml.datatype.XMLGregorianCalendar. |
static java.util.List<javax.xml.datatype.XMLGregorianCalendar> |
sort(java.util.Collection<javax.xml.datatype.XMLGregorianCalendar> tstamps)
Returns a newly created sorted list of tstamps from the passed collection. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static boolean isTimestamp(java.lang.String lexicalRepresentation)
lexicalRepresentation
- The string representation.
public static javax.xml.datatype.XMLGregorianCalendar makeTimestamp(java.lang.String rep) throws java.lang.Exception
rep
- The string representation.
java.lang.Exception
- If the string cannot be parsed into a timestamp.public static javax.xml.datatype.XMLGregorianCalendar makeTimestamp(java.sql.Timestamp tstamp)
tstamp
- The javax.sql.Timestamp
public static javax.xml.datatype.XMLGregorianCalendar makeTimestamp(long timeInMillis)
timeInMillis
- the specified time in milliseconds to convert.
public static javax.xml.datatype.XMLGregorianCalendar makeTimestamp(Day day)
day
- The day to be converted.
public static javax.xml.datatype.XMLGregorianCalendar incrementDays(javax.xml.datatype.XMLGregorianCalendar tstamp, int days)
tstamp
- The base date and time.days
- The number of days to increment. This can be a negative number.
public static javax.xml.datatype.XMLGregorianCalendar incrementHours(javax.xml.datatype.XMLGregorianCalendar tstamp, int hours)
tstamp
- The base date and time.hours
- The number of hours to increment. This can be a negative
number.
public static javax.xml.datatype.XMLGregorianCalendar incrementMinutes(javax.xml.datatype.XMLGregorianCalendar tstamp, int minutes)
tstamp
- The base date and time.minutes
- The number of minutes to increment. This can be a negative
number.
public static javax.xml.datatype.XMLGregorianCalendar incrementSeconds(javax.xml.datatype.XMLGregorianCalendar tstamp, int seconds)
tstamp
- The base date and time.seconds
- The number of seconds to increment. This can be a negative
number.
public static javax.xml.datatype.XMLGregorianCalendar incrementMilliseconds(javax.xml.datatype.XMLGregorianCalendar tstamp, long milliseconds)
tstamp
- The base date and time.milliseconds
- The number of milliseconds to increment. This can be a negative
number.
public static java.sql.Timestamp makeTimestamp(javax.xml.datatype.XMLGregorianCalendar calendar)
calendar
- The XML timestamp.
public static javax.xml.datatype.XMLGregorianCalendar makeTimestamp()
public static javax.xml.datatype.XMLGregorianCalendar getDefaultProjectStartTime()
public static javax.xml.datatype.XMLGregorianCalendar getDefaultProjectEndTime()
public static boolean isBogusStartTime(javax.xml.datatype.XMLGregorianCalendar startTime)
startTime
- The startTime in question.
public static boolean inBetween(javax.xml.datatype.XMLGregorianCalendar start, javax.xml.datatype.XMLGregorianCalendar tstamp, javax.xml.datatype.XMLGregorianCalendar end)
start
- The start time.tstamp
- The timestamp to test.end
- The end time.
public static boolean greaterThan(javax.xml.datatype.XMLGregorianCalendar time1, javax.xml.datatype.XMLGregorianCalendar time2)
time1
- The first time.time2
- The second time.
public static int daysBetween(javax.xml.datatype.XMLGregorianCalendar day1, javax.xml.datatype.XMLGregorianCalendar day2)
day1
- The first day.day2
- The second day.
public static boolean greaterThan(java.lang.String timeString1, java.lang.String timeString2)
timeString1
- The first time.timeString2
- The second time.
public static boolean lessThan(javax.xml.datatype.XMLGregorianCalendar time1, javax.xml.datatype.XMLGregorianCalendar time2)
time1
- The first time.time2
- The second time.
public static boolean equal(javax.xml.datatype.XMLGregorianCalendar time1, javax.xml.datatype.XMLGregorianCalendar time2)
time1
- The first time.time2
- The second time.
public static long diff(javax.xml.datatype.XMLGregorianCalendar time1, javax.xml.datatype.XMLGregorianCalendar time2)
time1
- Start.time2
- End.
public static boolean isTodayOrLater(javax.xml.datatype.XMLGregorianCalendar timestamp)
timestamp
- The timestamp of interest.
public static boolean isYesterdayOrLater(javax.xml.datatype.XMLGregorianCalendar timestamp)
timestamp
- The timestamp of interest.
public static java.util.List<javax.xml.datatype.XMLGregorianCalendar> sort(java.util.Collection<javax.xml.datatype.XMLGregorianCalendar> tstamps)
tstamps
- The timestamps to be sorted.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |