DosGetDateTime
DosGetDateTime gets the current date and time.
Syntax
DosGetDateTime ( pdtm )
Parameters
- pdtm - PDATETIME - input
- Pointer to a DATETIME structure where the date and time information is to be stored.
Returns
This function returns an APIRET with no values.
APIRET rc 0 NO_ERROR
Define (C/C++)
#define INCL_DOSDATETIME #include <os2.h>
Export name/Ordinal
DOSCALLS.DLL 230.
Relevant Structures
typedef struct _DATETIME
{
UCHAR hours; /* 0..23 */
UCHAR minutes; /* 0..59 */
UCHAR seconds; /* 0..59 */
UCHAR hundredths; /* 0..99, 1/100 s */
UCHAR day; /* 0..31 */
UCHAR month; /* 0..12 */
USHORT year;
SHORT timezone; /* Difference in minutes between current time zone */
/* and GMT. >0 = west of Greenwich, -1 = undefined */
/* time zone. */
UCHAR weekday; /* 0..6 0=Sunday */
} DATETIME, *PDATETIME;
Gotchas
The sign of the time zone is opposed to that ordinary used. Ie GMT+1 (Western Europe) <=> -60
Sample Code
PDATETIME pdtm;
DATETIME dtm;
APIRET rc;
...
pdtm = &dtm;
rc = DosGetDateTime (pdtm);
#define INCL_DOSDATETIME
#include <os2.h>
#include <stdio.h> /* For printf */
DATETIME dt;
APIRET rc;
rc=DosGetDateTime(&dt); /* Get current time and date */
printf("The time is %d:%d:%d\n",
(short)dt.hours,
(short)dt.minutes,
(short)dt.seconds);