DateTime Class

A class used to represent a point in time. The point in time is represented through properties that represent the calendar date and time-of-day.  

Example 1

The following calculates and displays a new DateTime that is 15 minutes greater than the current computer clock time:

using elsystem;

 

var: DateTime newTime(null);

 

newTime = DateTime.Now;

newTime.AddMinutes(15);

print("Current Time: ",DateTime.Now.tostring()," New Time: ",newTime.tostring());

 

Example 2

This example uses the Format method to display the date portion of the current DateTime in an alternate manner:

using elsystem;

 

print(Datetime.Now.Format(Format("%a %b %d, %Y"));        // Wed May 05, 2010

Remarks

If the day of the month is too large for the specified month then the day will be converted automatically to the appropriate day of the next month. The month and year will be incremented as necessary.

Thus, for example, an attempt to set the day value to 30 when the month value is 2 will cause the month to be incremented automatically to 3, and the day to be assigned the value 2 (or 1 if the year value is a leap year).

The example code below illustrates the automatic adjustments made to the month and day when the day value assigned is incompatible with the month value assigned:

using elsystem;

variables:

DateTime DTForTests( NULL );

 

once

begin

DTForTests = new DateTime;

DTForTests.Year = 2021;

DTForTests.Day = 30;

DTForTests.Month = 2;

 

// Prints 02/30/2021 becomes 03/02/2021

Print( "02/30/2021 becomes ", DTForTests.Format( "%m/%d/%Y" ) );

 

DTForTests.Year = 2020;

DTForTests.Day = 30;

DTForTests.Month = 2;

 

// Prints 02/30/2020 becomes 03/01/2020

Print( "02/30/2020 (a leap year) becomes ", DTForTests.Format( "%m/%d/%Y" ) );

end;

 

Namespace: elsystem