DosGetDateTime

DosGetDateTime

DosGetDateTime(pdtm)

Get the current date and time.

Syntax

rc = 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

DosGetDateTime. 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

Example Code

...
PDATETIME  pdtm;
DATETIME   dtm;
APIRET     rc;
...
pdtm = &dtm;
rc = DosGetDateTime (pdtm);
...

Sample Code

#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);

Related Functions

DosSetDateTime

OS Version Introduced

OS/2 1.x

Alternative Version

1. OS2Linux project (Common Public License) created a clone for this function [1].