IMPORTANT: In July 2025, we stopped releasing new versions of KTX modules, and we removed the KTX libraries from the Firebase Android BoM (v34.0.0). If you use KTX APIs from the previously released KTX modules, we recommend that you migrate your app to use KTX APIs from the main modules instead. For details, see the FAQ about this initiative.

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