Field Detail

• DATE_FORMAT_PREFERRED

  public static final java.lang.String DATE_FORMAT_PREFERRED

  See Also:

  Constant Field Values

• DATE_FORMAT_STAMP

  public static final java.lang.String DATE_FORMAT_STAMP

  See Also:

  Constant Field Values

• MILLIS_IN_SECOND

  public static final long MILLIS_IN_SECOND

  See Also:

  Constant Field Values

• MILLIS_IN_MINUTE

  public static final long MILLIS_IN_MINUTE

  See Also:

  Constant Field Values

• MILLIS_IN_HOUR

  public static final long MILLIS_IN_HOUR

  See Also:

  Constant Field Values

• MILLIS_IN_DAY

  public static final long MILLIS_IN_DAY

  See Also:

  Constant Field Values

• MILLIS_IN_YEAR

  public static final long MILLIS_IN_YEAR

  See Also:

  Constant Field Values

Constructor Detail

• Time

  public Time()

Method Detail

• 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)

• toDateString

  public static com.google.common.base.Function<java.lang.Long,java.lang.String> toDateString()

• makeDateStampString

  public static java.lang.String makeDateStampString()

  returns the current time in YYYYMMDD-HHMMSSmss format

• makeDateStampString

  public static java.lang.String makeDateStampString(long date)

  returns the time in YYYY-MM-DD HH:MM:SS.mss format, given a long (e.g. returned by System.currentTimeMillis)

• toDateStampString

  public static com.google.common.base.Function<java.lang.Long,java.lang.String> toDateStampString()

• makeTimeStringExact

  public static java.lang.String makeTimeStringExact(long t,
                                     java.util.concurrent.TimeUnit unit)

  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(com.google.common.base.Stopwatch timer)

• makeTimeStringExact

  public static java.lang.String makeTimeStringExact(long t)

  See Also:

  makeTimeString(long, boolean)

• makeTimeStringRounded

  public static java.lang.String makeTimeStringRounded(long t)

  See Also:

  makeTimeString(long, boolean)

• makeTimeStringRoundedSince

  public static java.lang.String makeTimeStringRoundedSince(long utc)

  See Also:

  makeTimeString(long, boolean)

• makeTimeStringExact

  public static java.lang.String makeTimeStringExact(Duration d)

  See Also:

  makeTimeString(long, boolean)

• makeTimeStringRounded

  public static java.lang.String makeTimeStringRounded(Duration d)

  See Also:

  makeTimeString(long, boolean)

• 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

• makeTimeStringNanoExact

  public static java.lang.String makeTimeStringNanoExact(long tn)

  See Also:

  makeTimeString(long, boolean)

• makeTimeStringNanoRounded

  public static java.lang.String makeTimeStringNanoRounded(long tn)

  See Also:

  makeTimeString(long, boolean)

• makeTimeStringNano

  public static java.lang.String makeTimeStringNano(long tn,
                                    boolean round)

  See Also:

  makeTimeString(long, boolean)

• fromLongToTimeStringExact

  public static com.google.common.base.Function<java.lang.Long,java.lang.String> fromLongToTimeStringExact()

• toTimeString

  @Deprecated
  public static com.google.common.base.Function<java.lang.Long,java.lang.String> toTimeString()

  Deprecated. since 0.7.0 use fromLongToTimeStringExact()

• fromLongToTimeStringRounded

  public static com.google.common.base.Function<java.lang.Long,java.lang.String> fromLongToTimeStringRounded()

• toTimeStringRounded

  @Deprecated
  public static com.google.common.base.Function<java.lang.Long,java.lang.String> toTimeStringRounded()

  Deprecated. since 0.7.0 use fromLongToTimeStringRounded()

• fromDurationToTimeStringRounded

  public static com.google.common.base.Function<Duration,java.lang.String> fromDurationToTimeStringRounded()

• sleep

  public static void sleep(long millis)

  sleep which propagates Interrupted as unchecked

• sleep

  public static void sleep(Duration duration)

  as sleep(long)

• 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.

• roundFromMillis

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

• roundFromMillis

  public static long roundFromMillis(long millis,
                     long millisPerUnit)

• 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.

• 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:

  java.lang.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:

  java.lang.NumberFormatException - if cannot be parsed (or if null)

• 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:

• 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)

  returns the duration elapsed since the given timestamp (UTC)

• hasElapsedSince

  public static boolean hasElapsedSince(long timestamp,
                        Duration duration)

  true iff it has been longer than the given duration since the given timestamp

• now

  public static long now()

  more readable and shorter convenience for System.currentTimeMillis()