View source for DosGetDateTime

==DosGetDateTime==
;DosGetDateTime(pdtm) : Get the current date and time. 

=== Syntax=== 
rc = DosGetDateTime( pdtm ); 

=== Parameters ===
; pdtm - [[OS2 API:DataType:PDATETIME|PDATETIME]] - input : Pointer to a [[OS2 API:DataType:DATETIME|DATETIME]] structure where the date and time information is to be stored.

=== Constants ===

=== Returns ===
This function returns an [[OS2 API:DataType:APIRET|APIRET]] with no values.

 APIRET  rc
 0       NO_ERROR

=== Module ===


=== Define (C/C++) ===
 #define INCL_DOSDATETIME
 #include <os2.h>

=== Export name/Ordinal ===
DosGetDateTime.  DOSCALLS.DLL 230.

=== Calling conversion ===

=== 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 ===
 ...
 [[OS2 API:DataType:PDATETIME|PDATETIME]]  pdtm;
 [[OS2 API:DataType:DATETIME|DATETIME]]   dtm;
 [[OS2 API:DataType:APIRET|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 ===
[[OS2 API:CPI:DosSetDateTime|DosSetDateTime]]

=== OS Version Introduced ===
OS/2 1.x

[[Category:The OS/2 API Project]]

==Alternative Version==
# OS2Linux project (Common Public License) created a clone for this function [https://github.com/OS2World/LINUX-SYSTEM-OS2Linux/blob/1eaffacb404b31b79068582ef8bf4d7583c8fa8d/os2/datetime.c].



[[Category:The OS/2 API Project]]