Timestamp

class Timestamp : Comparable, Parcelable

---

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. Furthermore,It is encoded assuming all minutes are 60 seconds long, specifically 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 also
	TimestampThe ref timestamp definition

Summary

Public companion functions
Timestamp	now()

Public companion properties
Parcelable.Creator<Timestamp>	CREATOR

Public constructors
Timestamp(date: Date)
@RequiresApi(value = 26) Timestamp(time: Instant)
Timestamp(seconds: Long, nanoseconds: Int) Creates a new Timestamp.

Public functions
open operator Int	compareTo(other: Timestamp)
open Int	describeContents()
open operator Boolean	equals(other: Any?)
open Int	hashCode()
Date	toDate() Returns a new Date corresponding to this timestamp.
Instant	@RequiresApi(value = 26) toInstant() Returns a new Instant that matches the time defined by this timestamp.
open String	toString()
open Unit	writeToParcel(dest: Parcel, flags: Int)

Public properties
Int	nanoseconds
Long	seconds

Public companion functions

now

fun now(): Timestamp

Public companion properties

CREATOR

val CREATOR: Parcelable.Creator<Timestamp>

Public constructors

Timestamp

Timestamp(date: Date)

Timestamp

@RequiresApi(value = 26)
Timestamp(time: Instant)

Timestamp

Timestamp(seconds: Long, nanoseconds: Int)

Creates a new Timestamp.

Parameters
seconds: Long	represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z inclusive.
nanoseconds: Int	represents non-negative fractions of a second at nanosecond resolution. Negative second values with fractions must still have non-negative nanoseconds values that count forward in time. Must be from 0 to 999,999,999 inclusive.

Public functions

compareTo

open operator fun compareTo(other: Timestamp): Int

describeContents

open fun describeContents(): Int

equals

open operator fun equals(other: Any?): Boolean

hashCode

open fun hashCode(): Int

toDate

fun toDate(): Date

Returns a new Date corresponding to this timestamp.

This may lose precision.

toInstant

@RequiresApi(value = 26)
fun toInstant(): Instant

Returns a new Instant that matches the time defined by this timestamp.

toString

open fun toString(): String

writeToParcel

open fun writeToParcel(dest: Parcel, flags: Int): Unit

Public properties

nanoseconds

val nanoseconds: Int

seconds

val seconds: Long