public class Timestamp extends Object
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.setSeconds(time(NULL));
timestamp.setNanos(0);
Example 2: Compute Timestamp from POSIX `gettimeofday()`.
struct timeval tv;
gettimeofday(&tv, NULL);
Timestamp timestamp;
timestamp.setSeconds(tv.tv_sec);
timestamp.setNanos(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.setSeconds((INT64) ((ticks / 10000000) - 11644473600LL));
timestamp.setNanos((INT32) ((ticks % 10000000) * 100));
Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
long millis = System.currentTimeMillis();
timestamp.setSeconds(millis / 1000);
timestamp.setNanos((int) ((millis % 1000) * 1000000));
| 构造器和说明 |
|---|
Timestamp() |
| 限定符和类型 | 方法和说明 |
|---|---|
Date |
getDate()
Gets the date.
|
Integer |
getNanos()
getter method for property nanos.
|
Long |
getSeconds()
getter method for property seconds.
|
void |
setDate(Date date)
Sets the date.
|
void |
setNanos(Integer nanos)
setter method for property nanos.
|
void |
setSeconds(Long seconds)
setter method for property seconds.
|
String |
toString() |
public Long getSeconds()
public void setSeconds(Long seconds)
seconds - the seconds to setpublic Integer getNanos()
public void setNanos(Integer nanos)
nanos - the nanos to setpublic void setDate(Date date)
date - the new datepublic Date getDate()
Copyright © 2022 Baidu, Inc.. All rights reserved.