Questions tagged [unix-timestamp]

The number of seconds between a particular date and the Unix Epoch on January 1st, 1970

POSIX definition

The POSIX.1 definition of Unix time is a number which is zero at the Unix epoch (1970-01-01T00:00:00Z), and increases by exactly 86 400 per day. Epoch and day ordinals are based on UTC.

The subtlety in this definition comes from the fact that days aren't exactly 86 400 seconds long. POSIX timestamps grow at 1Hz during the day, then end the day with small jumps to adjust for the duration of the UTC day.

For example, 2004-09-16T00:00:00Z, 12 677 days after the epoch, is represented by the Unix time number 12 677 × 86 400 = 1 095 292 800. The time interval between the epoch and 2004-09-16T00:00:00Z actually lasted 12 677 × 86 400 + 22 seconds.

This definition can be extended to represent instants before the epoch using negative numbers. 1957-10-04T00:00:00Z, 4 472 days before the epoch, is represented by the Unix time number -4 472 × 86 400 = -386 380 800. UTC is not defined for these instants, but universal time (any time standard that counts days from midnight at the reference meridian, such as the Julian Day) can be used, and the reduced accuracy is unlikely to matter.

POSIX provides for sub-second resolution with struct timespec, a fixed point format with a tv_nsec struct member for nanoseconds. This format is useful for system interfaces, but unsuitable for serialisation (naive range-checking could leave holes).

POSIX timestamps are ambiguous, discontinuous, and non-monotonic across leap seconds. When a leap second is inserted, a 1s range of Unix timestamps is repeated, first representing the leap second, then representing the first second of the next day (some implementations repeat the timestamp range immediately before the leap second instead). In the theoretical case of negative leap seconds, there would be 1s ranges of Unix time that do not represent any instant in time. The rest of the time, these Unix timestamps are continuous, unambiguous, and grow monotonically by 1s every second. The ambiguity isn't introduced by UTC, which measures time broken down in components and not as a single number.

System timestamps

On Unix systems, the CLOCK_REALTIME clock represents Unix time on a best-effort basis, based on hardware and network support. It may jump if the system clock is too far from reference time. Different clocks, representing different notions of system time, are exposed through clock_gettime. On Linux, CLOCK_MONOTONIC is monotonic and continuous (with no time elapsing when the system is suspended). It may speed up or slow down when adjtime is called, typically through NTP steering (clock slew). CLOCK_BOOTTIME is also monotonic, but will continue growing when the system is suspended. CLOCK_MONOTONIC_RAW is like CLOCK_MONOTONIC, but matches the speed of the hardware clock and ignores adjtime adjustments to clock speed. CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID count CPU time consumed by the process and thread, respectively. Linux also provides coarse variants that may provide better performance.

Timestamps recorded by the kernel (for example, modification times on filesystem inodes) follow the CLOCK_REALTIME clock.

Assuming CLOCK_REALTIME follows POSIX time, getting unambiguous time (UTC or TAI) from the kernel is an unsolved problem; adjtimex might expose enough internal state but it is highly implementation dependent. Breaking from the standard brings its own tradeoffs.

Alternative timestamps

POSIX.1b-1993 switched the definition of Unix timestamps away from a simple second count from the epoch. This introduced a few drawbacks: timestamps do not represent instants unambiguously, and Unix time is discontinuous and jumps backwards. The jumps are rare, thus hard to test for. Bugs can be subtle and are most likely to be discovered in production, after developers have moved on.

TAI-10 (TAI minus ten seconds) hits midnight at the Unix epoch. TAI is an ideal timestamp format; it grows perfectly linearly at 1/s.

Redefining CLOCK_REALTIME to follow an alternative to POSIX time is doable, but not advisable unless you control the system entirely. Setting the clock to TAI-10, applications that use localtime will still work, with /etc/localtime pointing to the Olson "right" timezones, but many applications expect to compute UTC days from timestamp / 86_400. Redefining CLOCK_REALTIME indirectly, through a tweaked NTP server, is more feasible; many applications will survive slightly varying clock speeds. This is the leap smear technique, which silently replaces UTC with UTC-SLS (smoothed leap seconds).

Other proposals aim to extend the clock_gettime interface instead of replacing the default clock. One is CLOCK_UTC, which encodes the leap second by growing tv_nsec beyond the [0, NSEC_PER_SEC] range, removing the ambiguity of CLOCK_REALTIME. The other is CLOCK_TAI, which simply encodes TAI.

time_t binary representation

ABIs where time_t is 32 bits are unable to represent times beyond January 2038; their timestamps will jump into the early twentieth century instead. This will prove a problem for some embedded systems that are being deployed now. clock_gettime/timespec_get, 64 bit integers, or other fixed-point formats like TAI64 should be used instead.

Use in protocols and serialisation

Unix timestamps are sometimes persisted, for example through serialisation or archive formats. Most filesystems use them for inode metadata. Internet protocols and formats systematically prefer RFC 3339/ISO 8601 datetimes. The SQL timestamp type is a Unix timestamp; when (fixed-offset) timezones are used, naive datetimes are translated to UTC at the storage boundary. TAI64 has been proposed to address the interoperability shortcomings of POSIX timestamps (and of time_t). When the extra compactness of integers isn't required, RFC 3339 UTC datetimes are self-describing and provide better portability, readability and widespread support.

2326 questions
13
votes
1 answer

Fetching UNIX epoch time in java

I was trying to fetch the current time in UTC in Java and came across this post: Getting "unixtime" in Java I checked out that all solutions new Date().getTime() System.currentTimeMillis() Instant.now().toEpochMillis() return the same value. I…
SohamC
  • 2,367
  • 6
  • 22
  • 34
13
votes
3 answers

Python add days in epoch time

How to add days in epoch time in Python #lssec -a lastupdate -s root -f /etc/security/passwd 2>/dev/null | cut -f2 -d= 1425917335 above command giving me epoch time I want to add 90 days in that time. how do I add days in epoch time?
Satish
  • 16,544
  • 29
  • 93
  • 149
13
votes
5 answers

SQlite: Column format for unix timestamp; Integer types

Original problem: What is the right column format for a unix timestamp? The net is full of confusion: some posts claim SQLite has no unsigned types - either whatsoever, or with exception of the 64bit int type (but there are (counter-)examples that…
SF.
  • 13,549
  • 14
  • 71
  • 107
13
votes
6 answers

UNIX date: How to convert week number (date +%W) to a date range (Mon-Sun)?

I have list of week numbers extracted from huge log file, they were extracted using syntax: $ date --date="Wed Mar 20 10:19:56 2012" +%W; 12 I want to create a simple bash function which can convert these week numbers to a date range. I suppose…
hellish
  • 411
  • 2
  • 6
  • 11
13
votes
3 answers

unix timestamp to boost::posix_time::ptime

I need to convert double with number of seconds since the epoch to ptime. I'm prety sure there must be an easy way to do this, but I couldn't find anything. Thanks. Edit: The original timestamp is floating point. I can't change it and i don't want…
cube
  • 3,867
  • 7
  • 32
  • 52
12
votes
2 answers

How to get current unixtime on Kotlin standard library (multiplatform)

I have a Kotlin multiplatform project, and I would like to get the current unixtime in the shared code. How do you do that in the Kotlin standard library?
Daniele B
  • 19,801
  • 29
  • 115
  • 173
12
votes
2 answers

What do Unix timestamps actually track?

I know that the Unix timestamp is defined as the number of seconds passed since 1970-01-01 00:00:00Z. However, I could not find a clear source that gives this definition. I've also read various different statements about the relationship between UTC…
Martin Thoma
  • 124,992
  • 159
  • 614
  • 958
12
votes
1 answer

Converting UNIX timestamp into date, hours, minutes, seconds

How can you convert the UNIX timestamp (that is in the form of a number denoting timestamp) into date, time(hours, minutes, seconds) in Objective-C?
neha
  • 6,327
  • 12
  • 46
  • 78
12
votes
4 answers

Convert Unix timestamp into datetime

I have the following data frame > head(try) creates time 1 128.29508 1417392072 3 236.98361 1417392072 7 98.45902 1417392072 9 157.44068 1417392131 10 227.38333 1417392131 11 242.03390 1417392131 > str(try) 'data.frame': 102968…
user3006691
  • 435
  • 3
  • 7
  • 16
12
votes
6 answers

easter_date() in JavaScript

I'm making a calendar generator in JavaScript. I need the Unix Timestamp for easter day midnight, for a given year. How can I do that (in JavaScript)? PHP's function can be found here.
user142019
12
votes
10 answers

Convert timestamp datatype into unix timestamp Oracle

I have a timestamp datatype in database with format 24-JuL-11 10.45.00.000000000 AM and want to get it converted into unix timestamp, how can I get it?
deepti
  • 185
  • 1
  • 3
  • 10
11
votes
2 answers

Carbon object to Unix timestamp based on timezone

I have a datetime string of format 'Y-m-d H:i:s', and datetime value as '2018-01-30 07:11:21'. $carbon_obj = Carbon::createFromFormat('Y-m-d H:i:s' , '2018-01-30 07:11:21','America/Chicago'); How do it get the Unix timestamp from this carbon…
Dinesh Gowda
  • 1,044
  • 3
  • 13
  • 29
11
votes
3 answers

UnixTime to readable date

What is the best way to convert UnixTime to a date? Is there a function for it or an algorithm?
SuperUser
  • 331
  • 2
  • 6
  • 21
10
votes
3 answers

Converting a unix time stamp to twitter/facebook style

I'm trying to convert a unix time stamp to display like facebook and twitter. For example, when you see tweets or comments placed on twitter/facebook you see the date/time displayed like so: '2 mins ago' or '2 days ago' or '2 weeks ago' Does anyone…
HomeBrew
  • 849
  • 2
  • 12
  • 25
10
votes
8 answers

unix command to find most recent directory created

I want to copy the files from the most recent directory created. How would I do so in unix? For example, if I have the directories names as date stamp as such: /20110311 /20110318 /20110325
jdamae
  • 3,839
  • 16
  • 58
  • 78