DosGetDateTime: Difference between revisions

Latest revision as of 11:24, 12 October 2018

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.

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

Related Functions

DosSetDateTime

@@ Line 1: / Line 1: @@
-==DosGetDateTime==
+'''DosGetDateTime''' gets the current date and time.
-;DosGetDateTime(pdtm) : Get the current date and time.
-=== Parameters ===
+== Syntax==
-; 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.
+ DosGetDateTime ( pdtm )
-=== Constants ===
+== Parameters ==
+;pdtm - [[PDATETIME]] - input: Pointer to a [[DATETIME]] structure where the date and time information is to be stored.
-=== Returns ===
+== Returns ==
-This function returns an [[OS2 API:DataType:APIRET|APIRET]] with no values.
+This function returns an [[APIRET]] with no values.
+ APIRET  rc
+       NO_ERROR
-=== Module ===
+== Define (C/C++) ==
-=== Define (C/C++) ===
   #define INCL_DOSDATETIME
   #include <os2.h>
-=== Export name/Ordinal ===
+== Export name/Ordinal ==
-DosGetDateTime.  DOSCALLS.DLL 230.
+  DOSCALLS.DLL 230.
-=== Calling conversion ===
+== Gotchas==
+The sign of the time zone is opposed to that ordinary used. Ie GMT+1 (Western Europe) <=> -60
-=== Example Code ===
+== Sample Code==
- ...
+<code>
-  [[OS2 API:DataType:PDATETIME|PDATETIME]]  pdtm;
+  PDATETIME  pdtm;
-  [[OS2 API:DataType:DATETIME|DATETIME]]   dtm;
+  DATETIME   dtm;
-  [[OS2 API:DataType:APIRET|APIRET]]     rc;
+  APIRET     rc;
   ...
   pdtm = &dtm;
   rc = DosGetDateTime (pdtm);
- ...
-=== Related Functions ===
+ #define INCL_DOSDATETIME
-[[OS2 API:DosSetDateTime|DosSetDateTime]]
+ #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);
+</code>
+== Related Functions ==
+*[[DosSetDateTime]]
-=== OS Version Introduced ===
+[[Category:Dos]]
-OS/2 1.x