DosSetDateTime

This call is used to set the date and time that are maintained by the operating system.

DosSetDateTime

(DateTime)

DateTime (PDATETIME) - input

Address of the date and time structure:

hours (UCHAR)

Current hour (0-23).
minutes (UCHAR)
Current minute (0-59).
seconds (UCHAR)
Current second (0-59).
hundredths (UCHAR)
Current hundredth of a second (0-99).
day (UCHAR)
Current day (1-31).
month (UCHAR)
Current month (1-12).
year (USHORT)
Current year (1980-2079).
timezone (SHORT)
Minutes west of UTC (Universal Time Coordinate -720 to 720).
weekday (UCHAR)
Current day of the week. This value is ignored and is calculated from the other parameter information.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 327
  ERROR_TS_DATETIME
  Remarks

  The value of timezone is the difference in minutes between the current time zone and UTC. This is a positive number if earlier than UTC, and negative number if it is later. For Eastern Standard Time this value is 300 (five hours earlier than UTC).

  To get the date and time, issue DosGetDateTime. If the application is executing in the OS/2 environment, it is more efficient to obtain these variables by calling DosGetInfoSeg instead of this function. However, applications written to the family API cannot depend on the availability of DosGetInfoSeg.

  Not adhering to the limits on any of the parameters results in the return code being set to rc = 327 (ERROR_TS_DATETIME). Also, OS/2 verifies that the day is possible for the month and the year (even for leap year). If the day is not reasonable, OS/2 will also set rc = 327.

  ---

  [Back: DosSetCp]
  [Next: DosSetFHandState]