Durations

java.lang.Object
- com.google.protobuf.util.Durations

```
public final class Durations
extends java.lang.Object
```
Utilities to help create/manipulate protobuf/duration.proto. All operations throw an IllegalArgumentException if the input(s) are not valid.

Field Summary

Fields
Modifier and Type	Field and Description
`private static java.util.Comparator<Duration>`	`COMPARATOR`
`(package private) static long`	`DURATION_SECONDS_MAX`
`(package private) static long`	`DURATION_SECONDS_MIN`
`static Duration`	`MAX_VALUE` A constant holding the maximum valid `Duration`, approximately `+10,000` years.
`static Duration`	`MIN_VALUE` A constant holding the minimum valid `Duration`, approximately `-10,000` years.

Constructor Summary

Constructors
Modifier Constructor and Description

private Durations()

Constructors
Modifier	Constructor and Description
`private`	`Durations()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Duration`	`add(Duration d1, Duration d2)` Add two durations.
`static Duration`	`checkValid(Duration duration)` Throws an `IllegalArgumentException` if the given `Duration` is not valid.
`static java.util.Comparator<Duration>`	`comparator()` Returns a `Comparator` for `Duration`s which sorts in increasing chronological order.
`static int`	`compare(Duration x, Duration y)` Compares two durations.
`static Duration`	`fromMicros(long microseconds)` Create a Duration from the number of microseconds.
`static Duration`	`fromMillis(long milliseconds)` Create a Duration from the number of milliseconds.
`static Duration`	`fromNanos(long nanoseconds)` Create a Duration from the number of nanoseconds.
`static Duration`	`fromSeconds(long seconds)` Create a Duration from the number of seconds.
`static boolean`	`isValid(Duration duration)` Returns true if the given `Duration` is valid.
`static boolean`	`isValid(long seconds, int nanos)` Returns true if the given number of seconds and nanos is a valid `Duration`.
`(package private) static Duration`	`normalizedDuration(long seconds, int nanos)`
`static Duration`	`parse(java.lang.String value)` Parse from a string to produce a duration.
`static Duration`	`subtract(Duration d1, Duration d2)` Subtract a duration from another.
`static long`	`toMicros(Duration duration)` Convert a Duration to the number of microseconds.
`static long`	`toMillis(Duration duration)` Convert a Duration to the number of milliseconds.
`static long`	`toNanos(Duration duration)` Convert a Duration to the number of nanoseconds.
`static long`	`toSeconds(Duration duration)` Convert a Duration to the number of seconds.
`static java.lang.String`	`toString(Duration duration)` Convert Duration to string format.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DURATION_SECONDS_MIN
```
static final long DURATION_SECONDS_MIN
```
    See Also:
    
    Constant Field Values
  - DURATION_SECONDS_MAX
```
static final long DURATION_SECONDS_MAX
```
    See Also:
    
    Constant Field Values
  - MIN_VALUE
```
public static final Duration MIN_VALUE
```
    A constant holding the minimum valid Duration, approximately -10,000 years.
  - MAX_VALUE
```
public static final Duration MAX_VALUE
```
    A constant holding the maximum valid Duration, approximately +10,000 years.
  - COMPARATOR
```
private static final java.util.Comparator<Duration> COMPARATOR
```
- Constructor Detail
  - Durations
```
private Durations()
```
- Method Detail
  - comparator
```
public static java.util.Comparator<Duration> comparator()
```
    Returns a Comparator for Durations which sorts in increasing chronological order. Nulls and invalid Durations are not allowed (see isValid(com.google.protobuf.Duration)).
  - compare
```
public static int compare(Duration x,
                          Duration y)
```
    Compares two durations. The value returned is identical to what would be returned by: Durations.comparator().compare(x, y).
    
    Returns:
    
    the value 0 if x == y; a value less than 0 if x < y; and a value greater than 0 if x > y
  - isValid
```
public static boolean isValid(Duration duration)
```
    Returns true if the given Duration is valid. The seconds value must be in the range [-315,576,000,000, +315,576,000,000]. The nanos value must be in the range [-999,999,999, +999,999,999].
    Note: Durations less than one second are represented with a 0 seconds field and a positive or negative nanos field. For durations of one second or more, a non-zero value for the nanos field must be of the same sign as the seconds field.
  - isValid
```
public static boolean isValid(long seconds,
                              int nanos)
```
    Returns true if the given number of seconds and nanos is a valid Duration. The seconds value must be in the range [-315,576,000,000, +315,576,000,000]. The nanos value must be in the range [-999,999,999, +999,999,999].
    Note: Durations less than one second are represented with a 0 seconds field and a positive or negative nanos field. For durations of one second or more, a non-zero value for the nanos field must be of the same sign as the seconds field.
  - checkValid
```
public static Duration checkValid(Duration duration)
```
    Throws an IllegalArgumentException if the given Duration is not valid.
  - toString
```
public static java.lang.String toString(Duration duration)
```
    Convert Duration to string format. The string format will contains 3, 6, or 9 fractional digits depending on the precision required to represent the exact Duration value. For example: "1s", "1.010s", "1.000000100s", "-3.100s" The range that can be represented by Duration is from -315,576,000,000 to +315,576,000,000 inclusive (in seconds).
    
    Returns:
    
    The string representation of the given duration.
    
    Throws:
    
    java.lang.IllegalArgumentException - if the given duration is not in the valid range.
  - parse
```
public static Duration parse(java.lang.String value)
                      throws java.text.ParseException
```
    Parse from a string to produce a duration.
    
    Returns:
    
    A Duration parsed from the string.
    
    Throws:
    
    java.text.ParseException - if parsing fails.
  - fromSeconds
```
public static Duration fromSeconds(long seconds)
```
    Create a Duration from the number of seconds.
  - toSeconds
```
public static long toSeconds(Duration duration)
```
    Convert a Duration to the number of seconds. The result will be rounded towards 0 to the nearest second. E.g., if the duration represents -1 nanosecond, it will be rounded to 0.
  - fromMillis
```
public static Duration fromMillis(long milliseconds)
```
    Create a Duration from the number of milliseconds.
  - toMillis
```
public static long toMillis(Duration duration)
```
    Convert a Duration to the number of milliseconds. The result will be rounded towards 0 to the nearest millisecond. E.g., if the duration represents -1 nanosecond, it will be rounded to 0.
  - fromMicros
```
public static Duration fromMicros(long microseconds)
```
    Create a Duration from the number of microseconds.
  - toMicros
```
public static long toMicros(Duration duration)
```
    Convert a Duration to the number of microseconds. The result will be rounded towards 0 to the nearest microseconds. E.g., if the duration represents -1 nanosecond, it will be rounded to 0.
  - fromNanos
```
public static Duration fromNanos(long nanoseconds)
```
    Create a Duration from the number of nanoseconds.
  - toNanos
```
public static long toNanos(Duration duration)
```
    Convert a Duration to the number of nanoseconds.
  - add
```
public static Duration add(Duration d1,
                           Duration d2)
```
    Add two durations.
  - subtract
```
public static Duration subtract(Duration d1,
                                Duration d2)
```
    Subtract a duration from another.
  - normalizedDuration
```
static Duration normalizedDuration(long seconds,
                                   int nanos)
```

Class Durations

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DURATION_SECONDS_MIN

DURATION_SECONDS_MAX

MIN_VALUE

MAX_VALUE

COMPARATOR

Constructor Detail

Durations

Method Detail

comparator

compare

isValid

isValid

checkValid

toString

parse

fromSeconds

toSeconds

fromMillis

toMillis

fromMicros

toMicros

fromNanos

toNanos

add

subtract

normalizedDuration