Durations (Protocol Buffers [Util] 3.3.1 API)

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

```
public final class Durations
extends 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
`static com.google.protobuf.Duration`	`MAX_VALUE` A constant holding the maximum valid `Duration`, approximately `+10,000` years.
`static com.google.protobuf.Duration`	`MIN_VALUE` A constant holding the minimum valid `Duration`, approximately `-10,000` years.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static com.google.protobuf.Duration`	`add(com.google.protobuf.Duration d1, com.google.protobuf.Duration d2)` Add two durations.
`static com.google.protobuf.Duration`	`checkValid(com.google.protobuf.Duration duration)` Throws an `IllegalArgumentException` if the given `Duration` is not valid.
`static Comparator<com.google.protobuf.Duration>`	`comparator()` Returns a `Comparator` for `Duration`s which sorts in increasing chronological order.
`static com.google.protobuf.Duration`	`fromMicros(long microseconds)` Create a Duration from the number of microseconds.
`static com.google.protobuf.Duration`	`fromMillis(long milliseconds)` Create a Duration from the number of milliseconds.
`static com.google.protobuf.Duration`	`fromNanos(long nanoseconds)` Create a Duration from the number of nanoseconds.
`static com.google.protobuf.Duration`	`fromSeconds(long seconds)` Create a Duration from the number of seconds.
`static boolean`	`isValid(com.google.protobuf.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`.
`static com.google.protobuf.Duration`	`parse(String value)` Parse from a string to produce a duration.
`static com.google.protobuf.Duration`	`subtract(com.google.protobuf.Duration d1, com.google.protobuf.Duration d2)` Subtract a duration from another.
`static long`	`toMicros(com.google.protobuf.Duration duration)` Convert a Duration to the number of microseconds.
`static long`	`toMillis(com.google.protobuf.Duration duration)` Convert a Duration to the number of milliseconds.
`static long`	`toNanos(com.google.protobuf.Duration duration)` Convert a Duration to the number of nanoseconds.
`static long`	`toSeconds(com.google.protobuf.Duration duration)` Convert a Duration to the number of seconds.
`static String`	`toString(com.google.protobuf.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
  - MIN_VALUE
```
public static final com.google.protobuf.Duration MIN_VALUE
```
    A constant holding the minimum valid Duration, approximately -10,000 years.
  - MAX_VALUE
```
public static final com.google.protobuf.Duration MAX_VALUE
```
    A constant holding the maximum valid Duration, approximately +10,000 years.
- Method Detail
  - comparator
```
public static Comparator<com.google.protobuf.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)).
  - isValid
```
public static boolean isValid(com.google.protobuf.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 com.google.protobuf.Duration checkValid(com.google.protobuf.Duration duration)
```
    Throws an IllegalArgumentException if the given Duration is not valid.
  - toString
```
public static String toString(com.google.protobuf.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:
    
    IllegalArgumentException - if the given duration is not in the valid range.
  - parse
```
public static com.google.protobuf.Duration parse(String value)
                                          throws ParseException
```
    Parse from a string to produce a duration.
    
    Returns:
    
    A Duration parsed from the string.
    
    Throws:
    
    ParseException - if parsing fails.
  - fromSeconds
```
public static com.google.protobuf.Duration fromSeconds(long seconds)
```
    Create a Duration from the number of seconds.
  - toSeconds
```
public static long toSeconds(com.google.protobuf.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 com.google.protobuf.Duration fromMillis(long milliseconds)
```
    Create a Duration from the number of milliseconds.
  - toMillis
```
public static long toMillis(com.google.protobuf.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 com.google.protobuf.Duration fromMicros(long microseconds)
```
    Create a Duration from the number of microseconds.
  - toMicros
```
public static long toMicros(com.google.protobuf.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 com.google.protobuf.Duration fromNanos(long nanoseconds)
```
    Create a Duration from the number of nanoseconds.
  - toNanos
```
public static long toNanos(com.google.protobuf.Duration duration)
```
    Convert a Duration to the number of nanoseconds.
  - add
```
public static com.google.protobuf.Duration add(com.google.protobuf.Duration d1,
                                               com.google.protobuf.Duration d2)
```
    Add two durations.
  - subtract
```
public static com.google.protobuf.Duration subtract(com.google.protobuf.Duration d1,
                                                    com.google.protobuf.Duration d2)
```
    Subtract a duration from another.

Class Durations

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MIN_VALUE

MAX_VALUE

Method Detail

comparator

isValid

isValid

checkValid

toString

parse

fromSeconds

toSeconds

fromMillis

toMillis

fromMicros

toMicros

fromNanos

toNanos

add

subtract