Duration (Performetrics 2.1.1 API)

java.lang.Object
- net.obvj.performetrics.util.Duration

```
public class Duration
extends Object
```
A time-based amount, such as '01:59:59.987654321 (H:M:S.ns)'.

This class models a quantity or amount of time in terms of:
- hours, from 0 to the maximum value that can be held in a long
- minutes within the hour, from 0 to 59
- seconds within the minute, from 0 to 59
- nanoseconds within the second, from 0 to 999,999,999
Since:

2.0.0

Author:

oswaldo.bapvic.jr

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Duration.FormatStyle
Enumerates different time format styles, each one with particular behaviors.

Nested Classes
Modifier and Type	Class and Description
`static class`	`Duration.FormatStyle` Enumerates different time format styles, each one with particular behaviors.

Field Summary

Fields
Modifier and Type Field and Description

static Duration ZERO

Fields
Modifier and Type	Field and Description
`static Duration`	`ZERO`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object object)`
`long`	`getHours()` Returns the number of hours in this duration.
`int`	`getMinutes()` Returns the number of minutes within the hour in this duration.
`int`	`getNanoseconds()` Returns the number of nanoseconds within the second in this duration.
`int`	`getSeconds()` Returns the number of seconds within the minute in this duration.
`int`	`hashCode()`
`static Duration`	`of(long amount, TimeUnit timeUnit)` Obtains a `Duration` representing an amount in the specified time unit.
`double`	`toSeconds()` Converts this duration to the total length in seconds and fractional nanoseconds, with a fixed scale of 9, so nanoseconds precision is preserved.
`String`	`toString()` Returns a string representation of this `Duration` in default format style.
`String`	`toString(Duration.FormatStyle style)` Returns a string representation of this`Duration` with custom format style.
`String`	`toString(Duration.FormatStyle style, boolean printLegend)` Returns a string representation of this`Duration` with custom format style.
`double`	`toTimeUnit(TimeUnit timeUnit)` Converts this duration to the total length in a given time unit, with default scale.
`double`	`toTimeUnit(TimeUnit timeUnit, int scale)` Converts this duration to the total length in a given time unit, with a custom scale.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - ZERO
```
public static final Duration ZERO
```
- Method Detail
  - of
```
public static Duration of(long amount,
                          TimeUnit timeUnit)
```
    Obtains a Duration representing an amount in the specified time unit.
    For example, calling Duration.of(65, SECONDS) produces an object with: [hours = 0, minutes = 1, seconds = 5, nanoseconds = 0]
    
    Parameters:
    
    amount - the amount of the duration, measured in term of the timeUnit argument; it must be a positive integer
    
    timeUnit - the unit that the amount argument is measured in; cannot be null
    
    Returns:
    
    a Duration, not null.
    
    Throws:
    
    IllegalArgumentException - if the specified amount is negative
    
    NullPointerException - if the specified timeUnit is null
  - getHours
```
public long getHours()
```
    Returns the number of hours in this duration.
    The hours field is a value from 0 to the maximum value that can be held in a long.
    
    Returns:
    
    the number of hours in this duration
  - getMinutes
```
public int getMinutes()
```
    Returns the number of minutes within the hour in this duration.
    The minutes field is a value from 0 to 59, which is an adjustment to the length in hours, retrieved by calling getHours().
    
    Returns:
    
    the minutes within the hours part of the length of the duration, from 0 to 59
  - getSeconds
```
public int getSeconds()
```
    Returns the number of seconds within the minute in this duration.
    The seconds field is a value from 0 to 59, which is an adjustment to the length in minutes, and hours, each part separately retrieved with their respective getter methods.
    
    Returns:
    
    the seconds within the minutes part of the length of the duration, from 0 to 59
  - getNanoseconds
```
public int getNanoseconds()
```
    Returns the number of nanoseconds within the second in this duration.
    The nanoseconds field is a value from 0 to 999,999,999, which is an adjustment to the length in seconds, minutes, and hours, each part separately retrieved with their respective getter methods.
    
    Returns:
    
    the nanoseconds within the seconds part of the length of the duration, from 0 to 999,999,999
  - equals
```
public boolean equals(Object object)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Returns a string representation of this Duration in default format style.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a string representation of this object
  - toString
```
public String toString(Duration.FormatStyle style)
```
    Returns a string representation of thisDuration with custom format style.
    Note: This is equivalent to calling: toString(style, true)
    
    Parameters:
    
    style - the Duration.FormatStyle to be applied
    
    Returns:
    
    a string representation of this object in the given style
  - toString
```
public String toString(Duration.FormatStyle style,
                       boolean printLegend)
```
    Returns a string representation of thisDuration with custom format style.
    
    Parameters:
    
    style - the Duration.FormatStyle to be applied
    
    printLegend - a flag indicating whether or not to include the legend in the generated string
    
    Returns:
    
    a string representation of this object in the given style
  - toTimeUnit
```
public double toTimeUnit(TimeUnit timeUnit)
```
    Converts this duration to the total length in a given time unit, with default scale.
    Note: The number of decimal places applied is determined by ConfigurationHolder.getConfiguration().getScale() and may be changed by calling Performetrics.setScale(int).
    
    Parameters:
    
    timeUnit - the target time unit
    
    Returns:
    
    the total length of the duration in the specified time unit, with default scale
  - toTimeUnit
```
public double toTimeUnit(TimeUnit timeUnit,
                         int scale)
```
    Converts this duration to the total length in a given time unit, with a custom scale.
    
    Parameters:
    
    timeUnit - the target time unit
    
    scale - a positive number indicates the number of decimal places to maintain; if negative, the default scale will be applied
    
    Returns:
    
    the total length of the duration in the specified time unit, with a custom scale, not null
  - toSeconds
```
public double toSeconds()
```
    Converts this duration to the total length in seconds and fractional nanoseconds, with a fixed scale of 9, so nanoseconds precision is preserved.
    Note: This is equivalent to calling: toTimeUnit(TimeUnit.SECONDS, 9)
    
    Returns:
    
    the total length of the duration in seconds, with a scale of 9, not null

Class Duration

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ZERO

Method Detail

of

getHours

getMinutes

getSeconds

getNanoseconds

equals

hashCode

toString

toString

toString

toTimeUnit

toTimeUnit

toSeconds