Function : Time
ConvertTIMEDATEPAIRToText - Converts binary TIMEDATE_PAIR to a character text string.
#include <misc.h> STATUS LNPUBLIC ConvertTIMEDATEPAIRToText( const void far *IntlFormat, const TFMT far *TextFormat, const TIMEDATE_PAIR far *InputTime, char far *retTextBuffer, WORD TextBufferLength, WORD far *retTextLength);
This function converts a Domino binary TIMEDATE_PAIR structure into a character text string. The character text string consists of two date strings separated by " - ".
You may also optionally request a non-standard format for the output string by setting up a TFMT or INTLFORMAT structures. Use NULL if the standard "current" settings is acceptable.
Parameters : Input : IntlFormat - The internationalization settings in effect. You retrieve these settings in an INTLFORMAT structure returned during a call to OSGetIntlSettings. This argument is a void pointer to the INTLFORMAT. Can be NULL, in which case this function invokes OSGetIntlSettings and works with those settings for the duration of this call.
TextFormat - A pointer to a TFMT structure -- which specifies the desired format of the character converted time/date string. Can be NULL, in which case this function creates a temporary version of the required TFMT structure and assigns the following values to its members:
td_format_ptr->Date = TDFMT_FULL; td_format_ptr->Time = TTFMT_FULL; td_format_ptr->Zone = TZFMT_NEVER; td_format_ptr->Structure = TSFMT_DATETIME;
InputTime - A pointer to the Domino binary time/date structure that you want to convert.
TextBufferLength - The length of the buffer pointed to by retTextBuffer minus one(1) or usually MAXALPHATIMEDATEPAIR.
Output : (routine) - Return status from this call -- indicates either success or what the error is. The return codes include:
NOERROR - conversion successful. ERR_BUFFER_OVERFLOW - Output Buffer Overflow. ERR_TDO_CONV - Invalid Time or Date Encountered. ERR_IFMT - Invalid International Format Specifier. ERR_TFMT - Invalid Time/Date Format Specifier.
retTextBuffer - The address of a text buffer in which the character text time/date result of the conversion is returned. The buffer must be declared with a length of (MAXALPHATIMEDATEPAIR) + 1. This includes 1 for a future NULL terminator. The returned text is not NULL terminated.
retTextLength - The address of a WORD in which the length of the converted character time/date pair text is returned.
Sample Usage :
/* Convert Time/Date Pair to Text */ binary_td_pair.Lower.Innards = binary_td2.Innards; binary_td_pair.Lower.Innards = binary_td2.Innards; binary_td_pair.Upper.Innards = binary_td3.Innards; binary_td_pair.Upper.Innards = binary_td3.Innards; td_string_ptr = &td_string_pair; if (error_status = ConvertTIMEDATEPAIRToText(&intl_format, &td_format, &binary_td_pair, td_string_ptr, MAXALPHATIMEDATEPAIR, &string_len)) goto Exit;