Chapter 3 DynaScript Predefined Objects

Date object

Object

Enables the storage and retrieval of dates and times. The Date object has no properties.

Standard: ECMAScript

Syntax

To use a Date's method:

Date.MethodName( parameter ) 

Description

The Date object may be constructed in any of these ways:

MyDateObj = new Date( )

MyDateObj = new Date( dateVal )

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

The following syntax creates an integer holding the number of milliseconds from midnight, January 1, 1970.

myInt = DateUTC( [year, [month [, date [, hours [, minutes [, seconds [, ms]]]]]]] )

The parameters are:

• dateVal A string (Jan 30, 1938) or the number of milliseconds in Universal Coordinated Time (previously known as Greenwhich Mean time) between the specified date and midnight January 1, 1970. To maintain accuracy a range between -2147483649 to 2147483647 may be used. Dates that are outside of this range should use the other Date constructor or a floating point.
• year The full year of the specified date. For example 1996. A value of 0 to 99 would be converted to a value between 1900 to 1999.
• month The month of the specified date. 0 is equal to January.
• date The date of the specified date.
• hours The hour of the specified date. 0 is equal to midnight. If minutes is specified, the hours attribute must also be set.
• minutes The number of minutes of the specified date. If seconds is specified, the minutes attribute must also be set.
• seconds The number of seconds of the specified date. If milliseconds is specified, the seconds attribute must also be set.
• ms The number of milliseconds of the specified date.

The Date object has both a built-in object as well as constructors that allow users to create instances of a Date object. When referring to Date in the syntax sections of this chapter, we are referring to an instance of the Date object, not the built-in Date object.

If a value for the date object goes beyond its boundaries, the other values will be modified accordingly. For example if 14 is the given value for the month parameter, the month value will be equal to March.

Example

• This example uses the Date constructor to create a date object:
  

  <!--SCRIPT 
     myDateObj = new Date("98", "01", "11", "8","30")
  -->

  
  

See also

"valueOf method"

Copyright © 1999 Sybase, Inc. All rights reserved.