JavaScript time values: dates as milliseconds since 1970-01-01

By -
This blog post explains how JavaScript dates are stored internally as time values, milliseconds since 1970-01-01.


What the date API calls time is called a time value by the ECMAScript specification. It is a primitive number that encodes a date as milliseconds since 1 January 1970 00:00:00 UTC. Each date object stores its state as a time value, in the internal property [[PrimitiveValue]] (the same property that instances of the wrapper constructors Boolean, Number, and String use to store their wrapped primitive values).


Warning: Leap seconds are ignored in time values.


The following methods work with time values:


  • new Date(timeValue) uses a time value to create a date.

  • Date.parse(dateTimeString) parses a string with a date time string and returns a time value.

  • Date.now() returns the current date time as a time value.

  • Date.UTC(year, month, date?, hours?, minutes?, seconds?, milliseconds?) interprets the parameters relative to UTC and returns a time value.

  • Date.prototype.getTime() returns the time value stored in the receiver.

  • Date.prototype.setTime(timeValue) changes the date as specified via a time value.

  • Date.prototype.valueOf() returns the time value stored in the receiver. This method determines how dates are converted to primitives, as explained in the next subsection.



The range of JavaScript integers (53 bits plus a sign, see [1]) is large enough that a time span can be represented that starts at approximately 285,616 years before 1970 and ends at approximately 285,616 years after 1970.


A few examples of converting dates to time values:


    > new Date('1970-01-01').getTime()
    0
    > new Date('1970-01-02').getTime()
    86400000
    > new Date('1960-01-02').getTime()
    -315532800000


The Date constructor enables you to convert times values to dates:


    > new Date(0)
    Date {Thu Jan 01 1970 01:00:00 GMT+0100 (CET)}
    > new Date(24 * 60 * 60 * 1000)  // 1 day in ms
    Date {Fri Jan 02 1970 01:00:00 GMT+0100 (CET)}
    > new Date(-315532800000)
    Date {Sat Jan 02 1960 01:00:00 GMT+0100 (CET)}


Converting a Date to a Number



A date is converted to a number [2] via Date.prototype.valueOf(), which returns a time value. This allows you to compare dates:


    > new Date('1980-05-21') > new Date('1980-05-20')
    true


You can also perform arithmetic, but beware that leap seconds are ignored:


    > new Date('1980-05-21') - new Date('1980-05-20')
    86400000


Reference




  1. What are integers in JavaScript?

  2. Coercing objects to primitives

Comments

Post a Comment

Popular posts from this blog

Steve Lopez and the Importance of Newspapers

By -
Image
It has been one year since I cancelled my subscriptions to The New York Times and the Los Angeles Times . In that time, I continued to read both publications online. My assessment of this experiment is that reading newspapers and journalism online is vastly inferior to the hard copy thrown on my porch each morning. So I restarted my subscription to the Los Angeles Times and I have made it a point to buy The New York Times as often as I pass one of those coin boxes or my local news stand. The catalyst for this re-evaluation resulted from catching the film, The Soloist on cable last week. I liked the movie, although the scenes I found most interesting were the ones that showed columnist Steve Lopez at work. I realized the book was sitting in my “to-read” stack, so I pulled it and began reading. The book, as I expected, is better than the film. Lopez clearly addresses the revolution occurring in journalism, and worries about his future with the paper even as he researches and writes...
Keep reading

Ideas for fixing unconnected computing

By -
I traveled quite a bit recently and got exposed to a negative aspect of current technology: Things work well if you have a solid internet connection with no traffic limits and are plugged into a power outlet. Otherwise, things do not work well at all. This blog post describes the problems that arise and suggests solutions. Managing data traffic Cell phones are quite good at conserving traffic, laptops much less so. This becomes a problem when your laptop has a mobile connection (e.g., via tethering or in a hotel with data caps). I once accidentally started iTunes in such a situation and immediately used up my daily allowance of traffic. Similarly, mobile email is frugal with traffic (only the current folder is updated, attachments are only downloaded on demand, etc.), desktop email is usually not. How can this be handled better? I’d like to see three traffic modes for all operating systems: “full”, “restricted”, “minimal”: In full traffic mode , all data transfers are allowed and happe...
Keep reading

Omar to kill me

By -
Image
  The sentence “ Omar m’a tuer ” is unintelligible French, as if it had been written by an illiterate person. At first sight, Mme Ghislaine Marchal —the author of those words in blood—seems to be saying that she had been killed by Omar in her villa at Mougins (Alpes-Maritimes). But why would that dying French lady have used such poor grammar? On that flimsy evidence, in 1991, the Moroccan gardener Omar Raddad was condemned and jailed. But he persisted non-stop upon his innocence. In 1998, he was liberated, and now lives in Morocco. A recent analysis of DNA specimens from the scene of the crime provides new facts. Four males, none of whom was Omar Raddad, have left traces of their presence. Will the real murderer be identified at last?
Keep reading