Protocol Buffers [Util] 3.7.1 · com.google.protobuf.util.TimeUtil

Modifier and Type	Field and Description
public static final long	DURATION_SECONDS_MAX
public static final long	DURATION_SECONDS_MIN
private static final long	NANOS_PER_SECOND
private static final BigInteger	NANOS_PER_SECOND_BIG_INTEGER
public static final long	TIMESTAMP_SECONDS_MAX
public static final long	TIMESTAMP_SECONDS_MIN

Access	Constructor and Description
private	TimeUtil()

Method Summary

Modifier and Type	Method and Description
public static Timestamp	add(Timestamp start, Duration length) Deprecated Use `Timestamps#add` instead. Add a duration to a timestamp.
public static Duration	add(Duration d1, Duration d2) Deprecated Use `Durations#add` instead. Add two durations.
private static Duration	createDurationFromBigInteger(BigInteger value)
public static Duration	createDurationFromMicros(long microseconds) Deprecated Use `Durations#fromMicros` instead. Create a Duration from the number of microseconds.
public static Duration	createDurationFromMillis(long milliseconds) Deprecated Use `Durations#fromMillis` instead. Create a Duration from the number of milliseconds.
public static Duration	createDurationFromNanos(long nanoseconds) Deprecated Use `Durations#fromNanos` instead. Create a Duration from the number of nanoseconds.
public static Timestamp	createTimestampFromMicros(long microseconds) Deprecated Use `Timestamps#fromMicros` instead. Create a Timestamp from the number of microseconds elapsed from the epoch.
public static Timestamp	createTimestampFromMillis(long milliseconds) Deprecated Use `Timestamps#fromMillis` instead. Create a Timestamp from the number of milliseconds elapsed from the epoch.
public static Timestamp	createTimestampFromNanos(long nanoseconds) Deprecated Use `Timestamps#fromNanos` instead. Create a Timestamp from the number of nanoseconds elapsed from the epoch.
public static Duration	distance(Timestamp from, Timestamp to) Deprecated Use `Timestamps#between` instead. Calculate the difference between two timestamps.
public static Duration	divide(Duration duration, double value)
public static Duration	divide(Duration duration, long times)
public static long	divide(Duration d1, Duration d2)
public static Timestamp	getCurrentTime() Deprecated Use `Timestamps.fromMillis(System.currentTimeMillis())` instead. Get the current time.
public static Timestamp	getEpoch() Deprecated Use `Timestamps.fromMillis(0)` instead. Get the epoch.
public static Duration	multiply(Duration duration, double times)
public static Duration	multiply(Duration duration, long times)
private static Duration	normalizedDuration(long seconds, int nanos)
public static Duration	Returns: A Duration parsed from the string. parseDuration(String value) Deprecated Use `Durations#parse` instead. Parse from a string to produce a duration.
public static Timestamp	Returns: A Timestamp parsed from the string. parseTimestamp(String value) Deprecated Use `Timestamps#parse` instead. Parse from RFC 3339 date string to Timestamp.
public static Duration	remainder(Duration d1, Duration d2)
public static Timestamp	subtract(Timestamp start, Duration length) Deprecated Use `Timestamps#subtract` instead. Subtract a duration from a timestamp.
public static Duration	subtract(Duration d1, Duration d2) Deprecated Use `Durations#subtract` instead. Subtract a duration from another.
private static BigInteger	toBigInteger(Duration duration)
private static BigInteger	toBigInteger(long value)
public static long	toMicros(Timestamp timestamp) Deprecated Use `Timestamps#toMicros` instead. Convert a Timestamp to the number of microseconds elapsed from the epoch.
public static long	toMicros(Duration duration) Deprecated Use `Durations#toMicros` instead. Convert a Duration to the number of microseconds.The result will be rounded towards 0 to the nearest microseconds.
public static long	toMillis(Timestamp timestamp) Deprecated Use `Timestamps#toMillis` instead. Convert a Timestamp to the number of milliseconds elapsed from the epoch.
public static long	toMillis(Duration duration) Deprecated Use `Durations#toMillis` instead. Convert a Duration to the number of milliseconds.The result will be rounded towards 0 to the nearest millisecond.
public static long	toNanos(Timestamp timestamp) Deprecated Use `Timestamps#toNanos` instead. Convert a Timestamp to the number of nanoseconds elapsed from the epoch.
public static long	toNanos(Duration duration) Deprecated Use `Durations#toNanos` instead. Convert a Duration to the number of nanoseconds.
public static String	Returns: The string representation of the given timestamp. toString(Timestamp timestamp) Deprecated Use `Timestamps#toString` instead. Convert Timestamp to RFC 3339 date string format.
public static String	Returns: The string representation of the given duration. toString(Duration duration) Deprecated Use `Durations#toString` instead. Convert Duration to string format.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

DURATION_SECONDS_MAX	back to summary
public static final long DURATION_SECONDS_MAX

DURATION_SECONDS_MIN	back to summary
public static final long DURATION_SECONDS_MIN

NANOS_PER_SECOND	back to summary
private static final long NANOS_PER_SECOND

NANOS_PER_SECOND_BIG_INTEGER	back to summary
private static final BigInteger NANOS_PER_SECOND_BIG_INTEGER

TIMESTAMP_SECONDS_MAX	back to summary
public static final long TIMESTAMP_SECONDS_MAX

TIMESTAMP_SECONDS_MIN	back to summary
public static final long TIMESTAMP_SECONDS_MIN

TimeUtil	back to summary
private TimeUtil()

Method Detail

add back to summary

add	back to summary
public static Timestamp add(Timestamp start, Duration length) Deprecated Use `Timestamps#add` instead. Add a duration to a timestamp. Annotations @Deprecated

public static Timestamp add(Timestamp start, Duration length)

Deprecated

Use Timestamps#add instead.

Add a duration to a timestamp.

Annotations

@Deprecated

add back to summary

add	back to summary
public static Duration add(Duration d1, Duration d2) Deprecated Use `Durations#add` instead. Add two durations. Annotations @Deprecated

public static Duration add(Duration d1, Duration d2)

Deprecated

Use Durations#add instead.

Add two durations.

Annotations

@Deprecated

createDurationFromBigInteger	back to summary
private static Duration createDurationFromBigInteger(BigInteger value)

createDurationFromMicros back to summary

createDurationFromMicros	back to summary
public static Duration createDurationFromMicros(long microseconds) Deprecated Use `Durations#fromMicros` instead. Create a Duration from the number of microseconds. Annotations @Deprecated

public static Duration createDurationFromMicros(long microseconds)

Deprecated

Use Durations#fromMicros instead.

Create a Duration from the number of microseconds.

Annotations

@Deprecated

createDurationFromMillis back to summary

createDurationFromMillis	back to summary
public static Duration createDurationFromMillis(long milliseconds) Deprecated Use `Durations#fromMillis` instead. Create a Duration from the number of milliseconds. Annotations @Deprecated

public static Duration createDurationFromMillis(long milliseconds)

Deprecated

Use Durations#fromMillis instead.

Create a Duration from the number of milliseconds.

Annotations

@Deprecated

createDurationFromNanos back to summary

createDurationFromNanos	back to summary
public static Duration createDurationFromNanos(long nanoseconds) Deprecated Use `Durations#fromNanos` instead. Create a Duration from the number of nanoseconds. Annotations @Deprecated

public static Duration createDurationFromNanos(long nanoseconds)

Deprecated

Use Durations#fromNanos instead.

Create a Duration from the number of nanoseconds.

Annotations

@Deprecated

createTimestampFromMicros back to summary

createTimestampFromMicros	back to summary
public static Timestamp createTimestampFromMicros(long microseconds) Deprecated Use `Timestamps#fromMicros` instead. Create a Timestamp from the number of microseconds elapsed from the epoch. Annotations @Deprecated

public static Timestamp createTimestampFromMicros(long microseconds)

Deprecated

Use Timestamps#fromMicros instead.

Create a Timestamp from the number of microseconds elapsed from the epoch.

Annotations

@Deprecated

createTimestampFromMillis back to summary

createTimestampFromMillis	back to summary
public static Timestamp createTimestampFromMillis(long milliseconds) Deprecated Use `Timestamps#fromMillis` instead. Create a Timestamp from the number of milliseconds elapsed from the epoch. Annotations @Deprecated

public static Timestamp createTimestampFromMillis(long milliseconds)

Deprecated

Use Timestamps#fromMillis instead.

Create a Timestamp from the number of milliseconds elapsed from the epoch.

Annotations

@Deprecated

createTimestampFromNanos back to summary

createTimestampFromNanos	back to summary
public static Timestamp createTimestampFromNanos(long nanoseconds) Deprecated Use `Timestamps#fromNanos` instead. Create a Timestamp from the number of nanoseconds elapsed from the epoch. Annotations @Deprecated

public static Timestamp createTimestampFromNanos(long nanoseconds)

Deprecated

Use Timestamps#fromNanos instead.

Create a Timestamp from the number of nanoseconds elapsed from the epoch.

Annotations

@Deprecated

distance back to summary

distance	back to summary
public static Duration distance(Timestamp from, Timestamp to) Deprecated Use `Timestamps#between` instead. Calculate the difference between two timestamps. Annotations @Deprecated

public static Duration distance(Timestamp from, Timestamp to)

Deprecated

Use Timestamps#between instead.

Calculate the difference between two timestamps.

Annotations

@Deprecated

divide	back to summary
public static Duration divide(Duration duration, double value)

divide	back to summary
public static Duration divide(Duration duration, long times)

divide	back to summary
public static long divide(Duration d1, Duration d2)

getCurrentTime back to summary

getCurrentTime	back to summary
public static Timestamp getCurrentTime() Deprecated Use `Timestamps.fromMillis(System.currentTimeMillis())` instead. Get the current time. Annotations @Deprecated

public static Timestamp getCurrentTime()

Deprecated

Use Timestamps.fromMillis(System.currentTimeMillis()) instead.

Get the current time.

Annotations

@Deprecated

getEpoch back to summary

getEpoch	back to summary
public static Timestamp getEpoch() Deprecated Use `Timestamps.fromMillis(0)` instead. Get the epoch. Annotations @Deprecated

public static Timestamp getEpoch()

Deprecated

Use Timestamps.fromMillis(0) instead.

Get the epoch.

Annotations

@Deprecated

multiply	back to summary
public static Duration multiply(Duration duration, double times) Annotations @SuppressWarnings:DurationSecondsToDouble

multiply	back to summary
public static Duration multiply(Duration duration, long times)

normalizedDuration	back to summary
private static Duration normalizedDuration(long seconds, int nanos)

parseDuration back to summary

parseDuration	back to summary
public static Duration parseDuration(String value) throws ParseException Deprecated Use `Durations#parse` instead. Parse from a string to produce a duration. Returns:Duration A Duration parsed from the string. Annotations @Deprecated Exceptions ParseException: if parsing fails.

public static Duration parseDuration(String value) throws ParseException

Deprecated

Use Durations#parse instead.

Parse from a string to produce a duration.

Returns:Duration

A Duration parsed from the string.

Annotations

@Deprecated

Exceptions

ParseException:: if parsing fails.

parseTimestamp back to summary

parseTimestamp	back to summary
public static Timestamp parseTimestamp(String value) throws ParseException Deprecated Use `Timestamps#parse` instead. Parse from RFC 3339 date string to Timestamp. This method accepts all outputs of `toString(Timestamp)` and it also accepts any fractional digits (or none) and any offset as long as they fit into nano-seconds precision. Example of accepted format: "1972-01-01T10:00:20.021-05:00" Returns:Timestamp A Timestamp parsed from the string. Annotations @Deprecated Exceptions ParseException: if parsing fails.

public static Timestamp parseTimestamp(String value) throws ParseException

Deprecated

Use Timestamps#parse instead.

Parse from RFC 3339 date string to Timestamp. This method accepts all outputs of toString(Timestamp) and it also accepts any fractional digits (or none) and any offset as long as they fit into nano-seconds precision.

Example of accepted format: "1972-01-01T10:00:20.021-05:00"

Returns:Timestamp

A Timestamp parsed from the string.

Annotations

@Deprecated

Exceptions

ParseException:: if parsing fails.

remainder	back to summary
public static Duration remainder(Duration d1, Duration d2)

subtract back to summary

subtract	back to summary
public static Timestamp subtract(Timestamp start, Duration length) Deprecated Use `Timestamps#subtract` instead. Subtract a duration from a timestamp. Annotations @Deprecated

public static Timestamp subtract(Timestamp start, Duration length)

Deprecated

Use Timestamps#subtract instead.

Subtract a duration from a timestamp.

Annotations

@Deprecated

subtract back to summary

subtract	back to summary
public static Duration subtract(Duration d1, Duration d2) Deprecated Use `Durations#subtract` instead. Subtract a duration from another. Annotations @Deprecated

public static Duration subtract(Duration d1, Duration d2)

Deprecated

Use Durations#subtract instead.

Subtract a duration from another.

Annotations

@Deprecated

toBigInteger	back to summary
private static BigInteger toBigInteger(Duration duration)

toBigInteger	back to summary
private static BigInteger toBigInteger(long value)

toMicros back to summary

toMicros	back to summary
public static long toMicros(Timestamp timestamp) Deprecated Use `Timestamps#toMicros` instead. Convert a Timestamp to the number of microseconds elapsed from the epoch. The result will be rounded down to the nearest microsecond. E.g., if the timestamp represents "1969-12-31T23:59:59.999999999Z", it will be rounded to -1 millisecond. Annotations @Deprecated

public static long toMicros(Timestamp timestamp)

Deprecated

Use Timestamps#toMicros instead.

Convert a Timestamp to the number of microseconds elapsed from the epoch.

The result will be rounded down to the nearest microsecond. E.g., if the timestamp represents "1969-12-31T23:59:59.999999999Z", it will be rounded to -1 millisecond.

Annotations

@Deprecated

toMicros back to summary

toMicros	back to summary
public static long toMicros(Duration duration) Deprecated Use `Durations#toMicros` instead. 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. Annotations @Deprecated

public static long toMicros(Duration duration)

Deprecated

Use Durations#toMicros instead.

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.

Annotations

@Deprecated

toMillis back to summary

toMillis	back to summary
public static long toMillis(Timestamp timestamp) Deprecated Use `Timestamps#toMillis` instead. Convert a Timestamp to the number of milliseconds elapsed from the epoch. The result will be rounded down to the nearest millisecond. E.g., if the timestamp represents "1969-12-31T23:59:59.999999999Z", it will be rounded to -1 millisecond. Annotations @Deprecated

public static long toMillis(Timestamp timestamp)

Deprecated

Use Timestamps#toMillis instead.

Convert a Timestamp to the number of milliseconds elapsed from the epoch.

The result will be rounded down to the nearest millisecond. E.g., if the timestamp represents "1969-12-31T23:59:59.999999999Z", it will be rounded to -1 millisecond.

Annotations

@Deprecated

toMillis back to summary

toMillis	back to summary
public static long toMillis(Duration duration) Deprecated Use `Durations#toMillis` instead. 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. Annotations @Deprecated

public static long toMillis(Duration duration)

Deprecated

Use Durations#toMillis instead.

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.

Annotations

@Deprecated

toNanos back to summary

toNanos	back to summary
public static long toNanos(Timestamp timestamp) Deprecated Use `Timestamps#toNanos` instead. Convert a Timestamp to the number of nanoseconds elapsed from the epoch. Annotations @Deprecated

public static long toNanos(Timestamp timestamp)

Deprecated

Use Timestamps#toNanos instead.

Convert a Timestamp to the number of nanoseconds elapsed from the epoch.

Annotations

@Deprecated

toNanos back to summary

toNanos	back to summary
public static long toNanos(Duration duration) Deprecated Use `Durations#toNanos` instead. Convert a Duration to the number of nanoseconds. Annotations @Deprecated

public static long toNanos(Duration duration)

Deprecated

Use Durations#toNanos instead.

Convert a Duration to the number of nanoseconds.

Annotations

@Deprecated

toString back to summary

toString	back to summary
public static String toString(Timestamp timestamp) Deprecated Use `Timestamps#toString` instead. Convert Timestamp to RFC 3339 date string format. The output will always be Z-normalized and uses 3, 6 or 9 fractional digits as required to represent the exact value. Note that Timestamp can only represent time from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. See https://www.ietf.org/rfc/rfc3339.txt Example of generated format: "1972-01-01T10:00:20.021Z" Returns:String The string representation of the given timestamp. Annotations @Deprecated Exceptions IllegalArgumentException: if the given timestamp is not in the valid range.

public static String toString(Timestamp timestamp)

Deprecated

Use Timestamps#toString instead.

Convert Timestamp to RFC 3339 date string format. The output will always be Z-normalized and uses 3, 6 or 9 fractional digits as required to represent the exact value. Note that Timestamp can only represent time from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. See https://www.ietf.org/rfc/rfc3339.txt

Example of generated format: "1972-01-01T10:00:20.021Z"

Returns:String

The string representation of the given timestamp.

Annotations

@Deprecated

Exceptions

IllegalArgumentException:: if the given timestamp is not in the valid range.

toString back to summary

toString	back to summary
public static String toString(Duration duration) Deprecated Use `Durations#toString` instead. 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:String The string representation of the given duration. Annotations @Deprecated Exceptions IllegalArgumentException: if the given duration is not in the valid range.

public static String toString(Duration duration)

Deprecated

Use Durations#toString instead.

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

The string representation of the given duration.

Annotations

@Deprecated

Exceptions

IllegalArgumentException:: if the given duration is not in the valid range.

public final Class TimeUtil

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail