Overview  Package   Class  Deprecated  Index  Help 
Brooklyn
FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

brooklyn.util.time
[Java] Class Time

java.lang.Object
  brooklyn.util.time.Time

public class Time
Field Summary
static java.lang.String DATE_FORMAT_PREFERRED

static long MILLIS_IN_DAY

static long MILLIS_IN_HOUR

static long MILLIS_IN_MINUTE

static long MILLIS_IN_SECOND

static long MILLIS_IN_YEAR

 
Method Summary
static java.util.Date dropMilliseconds(java.util.Date date)

removes milliseconds from the date object; needed if serializing to ISO-8601 format and want to serialize back and get the same data
static Duration elapsedSince(long timestamp)

true iff it has been longer than the given duration since the given timestamp
static long getTimeOfDayFromUtc(long timeUtc)

Calculates the number of milliseconds past midnight for a given UTC time.
static long getTimeUtc(java.util.TimeZone zone, int year, int month, int date, int hourOfDay, int minute, int second, int millis)

Calculates the number of milliseconds past epoch for a given UTC time.
static boolean hasElapsedSince(long timestamp, Duration duration)

more readable and shorter convenience for System.currentTimeMillis()
static java.lang.String makeDateString()

returns the current time in YYYY-MM-DD HH:MM:SS.mss format
static java.lang.String makeDateString(long date)

returns the time in YYYY-MM-DD HH:MM:SS.mss format, given a long (e.g. returned by System.currentTimeMillis)
static java.lang.String makeTimeString(long t, java.util.concurrent.TimeUnit unit)

@deprecated since 0.6.0 use makeTimeStringRounded(long, unit)
static java.lang.String makeTimeString(long t)

@deprecated since 0.6.0 use makeTimeStringRounded(long)
static java.lang.String makeTimeString(long t, boolean round)

given an elapsed time, makes it readable, eg 44d 6h, or 8s 923ms, optionally rounding
static java.lang.String makeTimeStringExact(long t, java.util.concurrent.TimeUnit unit)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringExact(long t)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringExact(Duration d)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringNano(long tn)

@deprecated since 0.6.0 use makeTimeStringNanoRounded
static java.lang.String makeTimeStringNano(long tn, boolean round)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringNanoExact(long tn)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringNanoLong(long tn)

@deprecated since 0.6.0 see other makeTimeString methods, they are more clearly defined than this
static java.lang.String makeTimeStringNanoRounded(long tn)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringRounded(long t, java.util.concurrent.TimeUnit unit)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringRounded(Stopwatch timer)

static java.lang.String makeTimeStringRounded(long t)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringRounded(Duration d)

@see #makeTimeString(long, boolean)
static java.lang.String makeTimeStringRoundedSince(long utc)

@see #makeTimeString(long, boolean)
static long now()

static java.util.Date parseDateString(java.lang.String dateString, java.text.DateFormat format)

Parses the given date, accepting either a UTC timestamp (i.e. a long), or a formatted date.
static long parseTimeString(java.lang.String timeString)

parses a string eg '5s' or '20m 22.123ms', returning the number of milliseconds it represents (rounded); -1 on blank or "never" or "off" or "false"; number of millis if no units specified.
static double parseTimeStringAsDouble(java.lang.String timeString)

parses a string eg '5s' or '20m 22.123ms', returning the number of milliseconds it represents; -1 on blank or never or off or false; number of millis if no units specified.
static long roundFromMillis(long millis, java.util.concurrent.TimeUnit units)

static long roundFromMillis(long millis, long millisPerUnit)

static void sleep(long millis)

sleep which propagates Interrupted as unchecked
static void sleep(Duration duration)

as sleep(long)
static long timeRemaining(long startTime, long maxTime)

Calculates how long until maxTime has passed since the given startTime.

 
Methods inherited from class java.lang.Object
java.lang.Object#wait(), java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()
 

Field Detail

DATE_FORMAT_PREFERRED

public static java.lang.String DATE_FORMAT_PREFERRED

MILLIS_IN_DAY

public static final long MILLIS_IN_DAY

MILLIS_IN_HOUR

public static final long MILLIS_IN_HOUR

MILLIS_IN_MINUTE

public static final long MILLIS_IN_MINUTE

MILLIS_IN_SECOND

public static final long MILLIS_IN_SECOND

MILLIS_IN_YEAR

public static final long MILLIS_IN_YEAR

 
Method Detail

dropMilliseconds

public static java.util.Date dropMilliseconds(java.util.Date date)
removes milliseconds from the date object; needed if serializing to ISO-8601 format and want to serialize back and get the same data

elapsedSince

public static Duration elapsedSince(long timestamp)
true iff it has been longer than the given duration since the given timestamp

getTimeOfDayFromUtc

public static long getTimeOfDayFromUtc(long timeUtc)
Calculates the number of milliseconds past midnight for a given UTC time.

getTimeUtc

public static long getTimeUtc(java.util.TimeZone zone, int year, int month, int date, int hourOfDay, int minute, int second, int millis)
Calculates the number of milliseconds past epoch for a given UTC time.

hasElapsedSince

public static boolean hasElapsedSince(long timestamp, Duration duration)
more readable and shorter convenience for System.currentTimeMillis()

makeDateString

public static java.lang.String makeDateString()
returns the current time in YYYY-MM-DD HH:MM:SS.mss format

makeDateString

public static java.lang.String makeDateString(long date)
returns the time in YYYY-MM-DD HH:MM:SS.mss format, given a long (e.g. returned by System.currentTimeMillis)

makeTimeString

ated
public static java.lang.String makeTimeString(long t, java.util.concurrent.TimeUnit unit)
deprecated:
since 0.6.0 use makeTimeStringRounded(long, unit)

makeTimeString

@Deprecated
public static java.lang.String makeTimeString(long t)
deprecated:
since 0.6.0 use makeTimeStringRounded(long)

makeTimeString

public static java.lang.String makeTimeString(long t, boolean round)
given an elapsed time, makes it readable, eg 44d 6h, or 8s 923ms, optionally rounding

makeTimeStringExact

public static java.lang.String makeTimeStringExact(long t, java.util.concurrent.TimeUnit unit)
See Also:
makeTimeString(long, boolean)

makeTimeStringExact

public static java.lang.String makeTimeStringExact(long t)
See Also:
makeTimeString(long, boolean)

makeTimeStringExact

public static java.lang.String makeTimeStringExact(Duration d)
See Also:
makeTimeString(long, boolean)

makeTimeStringNano

ated
	public
public static java.lang.String makeTimeStringNano(long tn)
deprecated:
since 0.6.0 use makeTimeStringNanoRounded

makeTimeStringNano

public static java.lang.String makeTimeStringNano(long tn, boolean round)
See Also:
makeTimeString(long, boolean)

makeTimeStringNanoExact

public static java.lang.String makeTimeStringNanoExact(long tn)
See Also:
makeTimeString(long, boolean)

makeTimeStringNanoLong

static String makeTimeStringNanoLong(long tn) {
		long t
public static java.lang.String makeTimeStringNanoLong(long tn)
deprecated:
since 0.6.0 see other makeTimeString methods, they are more clearly defined than this

makeTimeStringNanoRounded

public static java.lang.String makeTimeStringNanoRounded(long tn)
See Also:
makeTimeString(long, boolean)

makeTimeStringRounded

public static java.lang.String makeTimeStringRounded(long t, java.util.concurrent.TimeUnit unit)
See Also:
makeTimeString(long, boolean)

makeTimeStringRounded

public static java.lang.String makeTimeStringRounded(Stopwatch timer)

makeTimeStringRounded

public static java.lang.String makeTimeStringRounded(long t)
See Also:
makeTimeString(long, boolean)

makeTimeStringRounded

public static java.lang.String makeTimeStringRounded(Duration d)
See Also:
makeTimeString(long, boolean)

makeTimeStringRoundedSince

public static java.lang.String makeTimeStringRoundedSince(long utc)
See Also:
makeTimeString(long, boolean)

now

public static long now()

parseDateString

public static java.util.Date parseDateString(java.lang.String dateString, java.text.DateFormat format)
Parses the given date, accepting either a UTC timestamp (i.e. a long), or a formatted date.
Parameters:
dateString
format
Returns:

parseTimeString

public static long parseTimeString(java.lang.String timeString)
parses a string eg '5s' or '20m 22.123ms', returning the number of milliseconds it represents (rounded); -1 on blank or "never" or "off" or "false"; number of millis if no units specified.
throws:
NumberFormatException if cannot be parsed (or if null)

parseTimeStringAsDouble

public static double parseTimeStringAsDouble(java.lang.String timeString)
parses a string eg '5s' or '20m 22.123ms', returning the number of milliseconds it represents; -1 on blank or never or off or false; number of millis if no units specified.
throws:
NumberFormatException if cannot be parsed (or if null)

roundFromMillis

public static long roundFromMillis(long millis, java.util.concurrent.TimeUnit units)

roundFromMillis

public static long roundFromMillis(long millis, long millisPerUnit)

sleep

public static void sleep(long millis)
sleep which propagates Interrupted as unchecked

sleep

public static void sleep(Duration duration)
as sleep(long)

timeRemaining

public static long timeRemaining(long startTime, long maxTime)
Calculates how long until maxTime has passed since the given startTime. However, maxTime==0 is a special case (e.g. could mean wait forever), so the result is guaranteed to be only 0 if maxTime was 0; otherwise -1 will be returned.

 

Brooklyn Multi-Cloud Application Management Platform
brooklyncentral.github.com. Apache License. © 2012.