Converts the specified time and date value in EdmiPackedDate format to EdmiDate and EdmiStringDate formats.
Related functions: edmiGetPackedDate , edmiPackDate edmiStringToDate , edmiGetDate
Header:
#include "sdai.h"
Prototype:
EdmiError edmiUnpackDate(EdmiPackedDate packedDate,
EdmiDate *date,
EdmiStringDate *stringDate,
SdaiInteger stringFormat);
Arguments:
packedDate |
The time and date in EdmiPackedDate format to be converted. |
date |
Address of a variable of type EdmiDate that will receive the specified time and date in EdmiDate format. |
stringDate |
Address of a variable of type EdmiStringDate that will receive the specified time and date value in EdmiStringDate format. The actual value is located in a buffer in EDMinterface that can be overwritten by the next EDMinterface operation. |
stringFormat |
Dummy, not yet used. |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0 : Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
EXAMPLE
EdmiError rstat;
EdmiPackedDate packedDate;
EdmiDate date;
EdmiStringDate stringDate;
. . .
if (rstat = edmiUnpackDate (packedDate, &date, &stringDate, 0)) {
/* Error in operation */
printf("\nError: %s in edmiUnpackDate\n",
edmiGetErrorText(rstat));
goto error;
}
/* Printing out the returned string date */
printf("\nDate: %s", stringDate);
. . .