DateTime

DateTime functions and properties

DateTime.Now

(Formerly known as GetTime, which is now obsolete)

readonly static DateTime* DateTime.Now;

Gets the current system time. You could use this for timing a loop, or for effects like telling the player to go to bed, and so on.

A DateTime object is returned, which contains various properties that you can use.

Note that the DateTime object that you get will not be kept up to date with the current time; it will remain static with the time at which you called DateTime.Now.

Example:

DateTime *dt = DateTime.Now;
Display("The date is: %02d/%02d/%04d", dt.DayOfMonth, dt.Month, dt.Year);
Display("The time is: %02d:%02d:%02d", dt.Hour, dt.Minute, dt.Second);

will display the current date and time in 24-hour format

See also: DateTime.DayOfMonth, DateTime.Hour, DateTime.Minute, DateTime.Month, DateTime.RawTime, DateTime.Second, DateTime.Year

---

DateTime.CreateFromDate

static DateTime* DateTime.CreateFromDate(int year, int month, int day, int hour = 0, int minute = 0, int second = 0);

Returns a DateTime set as created. It returns invalid object if year is below 1970 or above 2038, or any other value is invalid.

Compatibility: Supported by AGS 3.6.2 and later versions.

See also: DateTime.Now, DateTime.CreateFromRawTime

---

DateTime.CreateFromRawTime

static DateTime* DateTime.CreateFromRawTime(int rawTime);

Creates DateTime object from the provided raw time value (in seconds). It returns invalid object if rawTime is negative

NOTE: the raw time mentioned here is sometimes also known as UNIX time, in 32-bit.

Compatibility: Supported by AGS 3.6.2 and later versions.

See also: DateTime.RawTime, DateTime.Now, DateTime.CreateFromDate

---

DateTime.DayOfMonth

readonly int DateTime.DayOfMonth;

Gets the day of the month represented by the DateTime object. This will be from 1 to 31, representing the current day within the month.

Example: For an example, see DateTime.Now.

See also: DateTime.Now

---

DateTime.Hour

readonly int DateTime.Hour;

Gets the hour represented by the DateTime object. This will be from 0 to 23, representing the hour in 24-hour format.

Example: For an example, see DateTime.Now.

See also: DateTime.Now

---

DateTime.Minute

readonly int DateTime.Minute;

Gets the minute represented by the DateTime object. This will be from 0 to 59, representing the minute in 24-hour format.

Example: For an example, see DateTime.Now.

See also: DateTime.Now

---

DateTime.Month

readonly int DateTime.Month;

Gets the month represented by the DateTime object. This will be from 1 to 12, representing the month of the year.

Example: For an example, see DateTime.Now.

See also: DateTime.Now

---

DateTime.RawTime

(Formerly known as GetRawTime, which is now obsolete)

readonly int DateTime.RawTime;

This function returns the raw system time, as the number of seconds since January 1970. While this value is not useful in itself, you can use it to calculate time differences by getting the value at the start of the game, for example, and then getting the value later on, and the difference between the two is how much time has elapsed.

NOTE: Because this accesses the real-time clock on the users' system, it is not a good idea to use this for long term timing tasks, since if the user saves the game and then restores it later, the Time value returned by this function will obviously include the difference when they were not playing.

Example:

DateTime *dt = DateTime.Now;
int start_time = dt.RawTime;
Wait(120);
dt = DateTime.Now;
Display("After the wait it is now %d seconds later.", dt.RawTime - start_time);

should display that 3 seconds have elapsed.

See also: DateTime.Now, SetTimer

---

DateTime.Second

readonly int DateTime.Second;

Gets the second represented by the DateTime object. This will be from 0 to 59, representing the second.

Example: For an example, see DateTime.Now.

See also: DateTime.Now

---

DateTime.Year

readonly int DateTime.Year;

Gets the year represented by the DateTime object. This is the full year, for example 2005.

Example: For an example, see DateTime.Now.

See also: DateTime.Now