openconsensus.trace

Class SpanData.Timestamp

java.lang.Object

openconsensus.trace.SpanData.Timestamp

Enclosing class:

SpanData

@Immutable
public abstract static class SpanData.Timestamp
extends Object

A representation of an instant in time. The instant is the number of nanoseconds after the number of seconds since the Unix Epoch.

Defined here instead of using Instant because the API needs to be Java 1.7 compatible.

Since:

0.1.0

Method Summary

Modifier and Type	Method and Description
static SpanData.Timestamp	create(long seconds, int nanos) Creates a new timestamp from given seconds and nanoseconds.
static SpanData.Timestamp	fromMillis(long epochMilli) Creates a new timestamp from the given milliseconds.
abstract int	getNanos() Returns the number of nanoseconds after the number of seconds since the Unix Epoch represented by this timestamp.
abstract long	getSeconds() Returns the number of seconds since the Unix Epoch represented by this timestamp.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static SpanData.Timestamp create(long seconds,
                                        int nanos)

Creates a new timestamp from given seconds and nanoseconds.

Parameters:

seconds - Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z inclusive.

nanos - Non-negative fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be from 0 to 999,999,999 inclusive.

Returns:

new Timestamp with specified fields.

Throws:

IllegalArgumentException - if the arguments are out of range.

Since:

0.1.0

fromMillis

public static SpanData.Timestamp fromMillis(long epochMilli)

Creates a new timestamp from the given milliseconds.

Parameters:

epochMilli - the timestamp represented in milliseconds since epoch.

Returns:

new Timestamp with specified fields.

Throws:

IllegalArgumentException - if the number of milliseconds is out of the range that can be represented by Timestamp.

Since:

0.1.0

getSeconds

public abstract long getSeconds()

Returns the number of seconds since the Unix Epoch represented by this timestamp.

Returns:

the number of seconds since the Unix Epoch.

Since:

0.1.0

getNanos

public abstract int getNanos()

Returns the number of nanoseconds after the number of seconds since the Unix Epoch represented by this timestamp.

Returns:

the number of nanoseconds after the number of seconds since the Unix Epoch.

Since:

0.1.0