Partager via


Date Object (Windows Scripting - JScript)

 

Enables basic storage and retrieval of dates and times.

Syntax

dateObj = new Date()dateObj = new Date(dateVal)dateObj = new Date(year, month, date[, hours[, minutes[, seconds[,ms]]]]) 

Arguments

  • dateObj
    Required. The variable name to which the Date object is assigned.

  • dateVal
    Required. If a numeric value, dateVal represents the number of milliseconds in Universal Coordinated Time between the specified date and midnight January 1, 1970. If a string, dateVal is parsed according to the rules in the parse method. The dateVal argument can also be a VT_DATE value as returned from some ActiveX objects.

  • year
    Required. The full year, for example, 1976 (and not 76).

  • month
    Required. The month as an integer between 0 and 11 (January to December).

  • date
    Required. The date as an integer between 1 and 31.

  • hours
    Optional. Must be supplied if minutes is supplied. An integer from 0 to 23 (midnight to 11pm) that specifies the hour.

  • minutes
    Optional. Must be supplied if seconds is supplied. An integer from 0 to 59 that specifies the minutes.

  • seconds
    Optional. Must be supplied if milliseconds is supplied. An integer from 0 to 59 that specifies the seconds.

  • ms
    Optional. An integer from 0 to 999 that specifies the milliseconds.

Remarks

A Date object contains a number representing a particular instant in time to within a millisecond. If the value of an argument is greater than its range or is a negative number, other stored values are modified accordingly. For example, if you specify 150 seconds, JScript redefines that number as two minutes and 30 seconds.

If the number is NaN, the object does not represent a specific instant of time. If you pass no parameters to the Date object, it is initialized to the current time (UTC). A value must be given to the object before you can use it.

The range of dates that can be represented in a Date object is approximately 285,616 years on either side of January 1, 1970.

The Date object has two static methods that are called without creating a Date object. They are parse and UTC.

See Date and Time Calculations (Windows Scripting - JScript) for more information about how to use the Date object and related methods.

The following example illustrates the use of the Date object.

function dateDemo() {
    var s = "Today's date is: ";

    // Create a date object.
    var dt = new Date();

    // Get the month, day, and year.
    s += (dt.getMonth() + 1) + "/";
    s += dt.getDate() + "/";
    s += dt.getFullYear();

    return (s);
}

Properties

constructor Property | prototype Property

Methods

getDate Method | getDay Method | getFullYear Method | getHours Method | getMilliseconds Method | getMinutes Method | getMonth Method | getSeconds Method | getTime Method | getTimezoneOffset Method | getUTCDate Method | getUTCDay Method | getUTCFullYear Method | getUTCHours Method | getUTCMilliseconds Method | getUTCMinutes Method | getUTCMonth Method | getUTCSeconds Method | getVarDate Method | getYear Method | parse Method | setDate Method | setFullYear Method | setHours Method | setMilliseconds Method | setMinutes Method | setMonth Method | setSeconds Method | setTime Method | setUTCDate Method | setUTCFullYear Method | setUTCHours Method | setUTCMilliseconds Method | setUTCMinutes Method | setUTCMonth Method | setUTCSeconds Method | setYear Method | toDateString Method | toGMTString Method | toJSON Method | toLocaleDateString Method | toLocaleString Method | toLocaleTimeString Method | toString Method | toTimeString Method | toUTCString Method | UTC Method | valueOf Method

Requirements

Version 1

See Also

new Operator (Windows Scripting - JScript)
var Statement (Windows Scripting - JScript)