setTimeout but for a given time

Question

Is there anything readily available in JavaScript (i.e. not through "plugins") that allows me to do something like setTimeout, but instead of saying in how many milliseconds something should happen, I give it a date object telling it when to do something?

setToHappen(function () {
    alert('Wake up!');
}, new Date("..."));

And yes, I know I can do this by simply subtracting new Date() with my existing date object (or maybe it's the other way around) to get the amount of milliseconds, but I'd still like to know.

Answer 1

No, but you could easily write your own function. Just calculate the diference between now and the given moment in miliseconds and call setTimeout with that.

Something like this:

 setToHappen = function(fn, date){
  var now = new Date().getTime();
  var diff = date.getTime() - now;
  var milliseconds = diff * 1000;
  return setTimeout(fn, milliseconds);
 }

Answer 2

You'd have to just find the number of milliseconds between now and your date object.

function setToHappen(fn, d){
    var t = d.getTime() - (new Date()).getTime();
    return setTimeout(fn, t);
}

Answer 3

Since people are talking about calculating timeout intervals using date objects, it should be noted that, in Firefox, the max value setTimeout() will accept for the interval parameter is 2147483647 (2^31 - 1) as PRIntervalTime is a signed 32-bit integer. That comes out to just under 25 days.