com.google.protobuf

Class Timestamp

java.lang.Object

com.google.protobuf.AbstractMessageLite<MessageType,BuilderType>

com.google.protobuf.GeneratedMessageLite<Timestamp,Timestamp.Builder>

com.google.protobuf.Timestamp

All Implemented Interfaces:

MessageLite, MessageLiteOrBuilder, TimestampOrBuilder

public final class Timestamp
extends GeneratedMessageLite<Timestamp,Timestamp.Builder>
implements TimestampOrBuilder

 A Timestamp represents a point in time independent of any time zone
 or calendar, represented as seconds and fractions of seconds at
 nanosecond resolution in UTC Epoch time. It is encoded using the
 Proleptic Gregorian Calendar which extends the Gregorian calendar
 backwards to year one. It is encoded assuming all minutes are 60
 seconds long, i.e. leap seconds are "smeared" so that no leap second
 table is needed for interpretation. Range is from
 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
 By restricting to that range, we ensure that we can convert to
 and from  RFC 3339 date strings.
 See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
 Example 1: Compute Timestamp from POSIX `time()`.
     Timestamp timestamp;
     timestamp.set_seconds(time(NULL));
     timestamp.set_nanos(0);
 Example 2: Compute Timestamp from POSIX `gettimeofday()`.
     struct timeval tv;
     gettimeofday(&tv, NULL);
     Timestamp timestamp;
     timestamp.set_seconds(tv.tv_sec);
     timestamp.set_nanos(tv.tv_usec * 1000);
 Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
     FILETIME ft;
     GetSystemTimeAsFileTime(&ft);
     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
     Timestamp timestamp;
     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
 Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
     long millis = System.currentTimeMillis();
     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
         .setNanos((int) ((millis % 1000) * 1000000)).build();
 Example 5: Compute Timestamp from current time in Python.
     now = time.time()
     seconds = int(now)
     nanos = int((now - seconds) * 10**9)
     timestamp = Timestamp(seconds=seconds, nanos=nanos)
 

Protobuf type google.protobuf.Timestamp

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Timestamp.Builder A Timestamp represents a point in time independent of any time zone or calendar, represented as seconds and fractions of seconds at nanosecond resolution in UTC Epoch time.

Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageLite

GeneratedMessageLite.DefaultInstanceBasedParser<T extends GeneratedMessageLite<T,?>>, GeneratedMessageLite.ExtendableBuilder<MessageType extends GeneratedMessageLite.ExtendableMessage<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.ExtendableBuilder<MessageType,BuilderType>>, GeneratedMessageLite.ExtendableMessage<MessageType extends GeneratedMessageLite.ExtendableMessage<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.ExtendableBuilder<MessageType,BuilderType>>, GeneratedMessageLite.ExtendableMessageOrBuilder<MessageType extends GeneratedMessageLite.ExtendableMessage<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.ExtendableBuilder<MessageType,BuilderType>>, GeneratedMessageLite.GeneratedExtension<ContainingType extends MessageLite,Type>, GeneratedMessageLite.MergeFromVisitor, GeneratedMessageLite.MethodToInvoke, GeneratedMessageLite.SerializedForm, GeneratedMessageLite.Visitor

Field Summary

Fields

Modifier and Type	Field and Description
static int	NANOS_FIELD_NUMBER
static int	SECONDS_FIELD_NUMBER

Fields inherited from class com.google.protobuf.GeneratedMessageLite

memoizedSerializedSize, unknownFields

Fields inherited from class com.google.protobuf.AbstractMessageLite

memoizedHashCode

Method Summary

Modifier and Type	Method and Description
protected Object	dynamicMethod(GeneratedMessageLite.MethodToInvoke method, Object arg0, Object arg1) A method that implements different types of operations described in GeneratedMessageLite.MethodToInvoke.
static Timestamp	getDefaultInstance()
int	getNanos() Non-negative fractions of a second at nanosecond resolution.
long	getSeconds() Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z.
int	getSerializedSize() Get the number of bytes required to encode this message.
static Timestamp.Builder	newBuilder()
static Timestamp.Builder	newBuilder(Timestamp prototype)
static Timestamp	parseDelimitedFrom(InputStream input)
static Timestamp	parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
static Timestamp	parseFrom(byte[] data)
static Timestamp	parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
static Timestamp	parseFrom(ByteString data)
static Timestamp	parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
static Timestamp	parseFrom(CodedInputStream input)
static Timestamp	parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
static Timestamp	parseFrom(InputStream input)
static Timestamp	parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
static Parser<Timestamp>	parser()
void	writeTo(CodedOutputStream output) Serializes the message and writes it to output.

Methods inherited from class com.google.protobuf.GeneratedMessageLite

dynamicMethod, dynamicMethod, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyLongList, emptyProtobufList, equals, getDefaultInstanceForType, getParserForType, hashCode, isInitialized, isInitialized, makeImmutable, makeImmutable, mergeLengthDelimitedField, mergeUnknownFields, mergeVarintField, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, newBuilderForType, newRepeatedGeneratedExtension, newSingularGeneratedExtension, parseDelimitedFrom, parseDelimitedFrom, parseFrom, parseFrom, parseFrom, parseFrom, parseFrom, parseFrom, parseFrom, parseFrom, parsePartialFrom, parseUnknownField, toBuilder, toString

Methods inherited from class com.google.protobuf.AbstractMessageLite

addAll, checkByteStringIsUtf8, toByteArray, toByteString, writeDelimitedTo, writeTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

getDefaultInstanceForType, isInitialized

Field Detail

SECONDS_FIELD_NUMBER

public static final int SECONDS_FIELD_NUMBER

See Also:

Constant Field Values

NANOS_FIELD_NUMBER

public static final int NANOS_FIELD_NUMBER

See Also:

Constant Field Values

Method Detail

getSeconds

public long getSeconds()

 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.
 

optional int64 seconds = 1;

Specified by:

getSeconds in interface TimestampOrBuilder

getNanos

public int getNanos()

 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.
 

optional int32 nanos = 2;

Specified by:

getNanos in interface TimestampOrBuilder

writeTo

public void writeTo(CodedOutputStream output)
             throws IOException

Description copied from interface: MessageLite

Serializes the message and writes it to output. This does not flush or close the stream.

Specified by:

writeTo in interface MessageLite

Throws:

IOException

getSerializedSize

public int getSerializedSize()

Description copied from interface: MessageLite

Get the number of bytes required to encode this message. The result is only computed on the first call and memoized after that.

Specified by:

getSerializedSize in interface MessageLite

parseFrom

public static Timestamp parseFrom(ByteString data)
                           throws InvalidProtocolBufferException

Throws:

InvalidProtocolBufferException

parseFrom

public static Timestamp parseFrom(ByteString data,
                                  ExtensionRegistryLite extensionRegistry)
                           throws InvalidProtocolBufferException

Throws:

InvalidProtocolBufferException

parseFrom

public static Timestamp parseFrom(byte[] data)
                           throws InvalidProtocolBufferException

Throws:

InvalidProtocolBufferException

parseFrom

public static Timestamp parseFrom(byte[] data,
                                  ExtensionRegistryLite extensionRegistry)
                           throws InvalidProtocolBufferException

Throws:

InvalidProtocolBufferException

parseFrom

public static Timestamp parseFrom(InputStream input)
                           throws IOException

Throws:

IOException

parseFrom

public static Timestamp parseFrom(InputStream input,
                                  ExtensionRegistryLite extensionRegistry)
                           throws IOException

Throws:

IOException

parseDelimitedFrom

public static Timestamp parseDelimitedFrom(InputStream input)
                                    throws IOException

Throws:

IOException

parseDelimitedFrom

public static Timestamp parseDelimitedFrom(InputStream input,
                                           ExtensionRegistryLite extensionRegistry)
                                    throws IOException

Throws:

IOException

parseFrom

public static Timestamp parseFrom(CodedInputStream input)
                           throws IOException

Throws:

IOException

parseFrom

public static Timestamp parseFrom(CodedInputStream input,
                                  ExtensionRegistryLite extensionRegistry)
                           throws IOException

Throws:

IOException

newBuilder

public static Timestamp.Builder newBuilder()

newBuilder

public static Timestamp.Builder newBuilder(Timestamp prototype)

dynamicMethod

protected final Object dynamicMethod(GeneratedMessageLite.MethodToInvoke method,
                                     Object arg0,
                                     Object arg1)

Description copied from class: GeneratedMessageLite

A method that implements different types of operations described in GeneratedMessageLite.MethodToInvoke. Theses different kinds of operations are required to implement message-level operations for builders in the runtime. This method bundles those operations to reduce the generated methods count.

• MERGE_FROM_STREAM is parameterized with an CodedInputStream and ExtensionRegistryLite. It consumes the input stream, parsing the contents into the returned protocol buffer. If parsing throws an InvalidProtocolBufferException, the implementation wraps it in a RuntimeException.
• NEW_INSTANCE returns a new instance of the protocol buffer that has not yet been made immutable. See MAKE_IMMUTABLE.
• IS_INITIALIZED is parameterized with a Boolean detailing whether to memoize. It returns null for false and the default instance for true. We optionally memoize to support the Builder case, where memoization is not desired.
• NEW_BUILDER returns a BuilderType instance.
• VISIT is parameterized with a Visitor and a MessageType and recursively iterates through the fields side by side between this and the instance.
• MAKE_IMMUTABLE sets all internal fields to an immutable state.

This method, plus the implementation of the Builder, enables the Builder class to be proguarded away entirely on Android.

For use by generated code only.

Specified by:

dynamicMethod in class GeneratedMessageLite<Timestamp,Timestamp.Builder>

getDefaultInstance

public static Timestamp getDefaultInstance()

parser

public static Parser<Timestamp> parser()