com.codelanx.codelanxlib.util

Class TimeUtil

java.lang.Object

com.codelanx.codelanxlib.util.TimeUtil

public final class TimeUtil
extends Object

Class description for TimeUtil

Since:

0.0.1

Version:

0.1.0

Author:

1Rogue

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TimeUtil.Countdown
static class	TimeUtil.TimePoint

Method Summary

Modifier and Type	Method and Description
static String	formatTime(long durationNS) Formats time in a readable output.
static String	formatTime(long durationNS, TimeUnit min) Formats time in a readable output.
static String	formatTime(TimeUtil.TimePoint point) Formats time in a readable output.
static String	formatTime(TimeUtil.TimePoint point, TimeUnit min) Formats time in a readable output.
static String	getProperUnitName(TimeUnit unit, long amount) Returns the appropriate spelling for a TimeUnit value based on the value of the "amount" parameter.
static String	getTime(long start)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getTime

public static String getTime(long start)

formatTime

public static String formatTime(long durationNS)

Formats time in a readable output.

Calling this method is equivalent to TimeUtil.formatTime(durationNS, TimeUnit.NANOSECONDS)

Parameters:

durationNS - The amount of time in nanoseconds

Returns:

The formatted string

Since:

0.0.1

See Also:

formatTime(long, TimeUnit)

formatTime

public static String formatTime(long durationNS,
                                TimeUnit min)

Formats time in a readable output. Creates a TimePoint out of the pass long in order to do so.

Calling this method is equivalent to TimeUtil.formatTime(TimePoint, TimeUnit.NANOSECONDS)

Parameters:

durationNS - The amount of time in nanoseconds

min - The minimum (inclusive) unit of time to output as a secondary measurement

Returns:

The formatted string

Since:

0.1.0

See Also:

formatTime(TimePoint, TimeUnit)

formatTime

public static String formatTime(TimeUtil.TimePoint point)

Formats time in a readable output.

Calling this method is equivalent to TimeUtil.formatTime(point, TimeUnit.NANOSECONDS)

Parameters:

point - The TimeUtil.TimePoint to use

Returns:

The formatted string

Since:

0.1.0

See Also:

formatTime(TimePoint, TimeUnit)

formatTime

public static String formatTime(TimeUtil.TimePoint point,
                                TimeUnit min)

Formats time in a readable output. Depending on the amount of time, the format will attempt to output the largest possible value first (e.g. days), followed by the next non-zero measurement of time (e.g., minutes). If there is no non-zero secondary measurement, it is excluded.

Parameters:

point - The TimeUtil.TimePoint to use

min - The minimum (inclusive) unit of time to output as a secondary measurement

Returns:

The formatted string

Since:

0.1.0

getProperUnitName

public static String getProperUnitName(TimeUnit unit,
                                       long amount)

Returns the appropriate spelling for a TimeUnit value based on the value of the "amount" parameter. Values other than 1 will return a plural measurement whereas 1 will return a singular measurement.

Parameters:

unit - The unit to beautify

amount - The amount relevant to the measurement output

Returns:

A formatted word

Since:

0.0.1