date.set

Syntax date.set (day, month, year, hour, minute, second)

Params day is a number representing the day component of the date you are defining.

month is a number representing the month component of the date you are defining.

year is a number representing the year component of the date you are defining.

hour is a number representing the hour component of the date you are defining.

minute is a number representing the minute component of the date you are defining.

second is a number representing the seconds component of the date you are defining.

Action Converts the six arguments into a date value, performing the necessary date arithmetic to convert to a valid date and time.

Returns The date

Examples date.set (23, 9, 91, 0, 0, 0)

   » 9/23/91 ; 12:00 AM

Note in this example that the first day is not in the range of September dates:
date.set (56, 9, 91, 0, 0, 0)


   » 10/26/91 ; 12:00 AM

Frontier calculates the new date 26 days after the end of September (which has 30 days), arriving at Oct. 26.

date.set (13, 13, 91, 9, 15, 0)

   » 1/13/92 ; 9:15 AM

There is no 13th month! Frontier goes to the first month past the 12th and reaches January. It knows it crossed a year boundary, so it makes the year 1992.

Notes This verb does not affect the system clock.

See Also date.get

clock.set

Discuss