informix
INFORMIX-ESQL/C Programmer's Manual
ESQL/C Function Library

rdatestr()

The rdatestr() function converts an internal DATE to a character string.

Syntax

Usage

For the default locale, U.S. English, the rdatestr() function determines how to interpret the format of the character string with the following precedence:

  1. The format that the DBDATE environment variable specifies (if DBDATE is set). For more information on DBDATE, ../sqlr/intro.htmler to the Informix Guide to SQL: Reference.
  2. The format that the GL_DATE environment variable specifies (if GL_DATE is set). For more information on GL_DATE, refer to the Informix Guide to GLS Functionality.
  3. The default date form: mm/dd/yyyy.

When you use a nondefault locale and do not set the DBDATE or GL_DATE environment variable, rdatestr() uses the date end-user format that the client locale defines. For more information, see the Informix Guide to GLS Functionality.

Return Codes

0 The conversion was successful.
<0 The conversion failed.
-1210 The internal date could not be converted to the character string format.
-1212 Data conversion format must contain a month, day, or year component. DBDATE specifies the data conversion format.

Example

The demo directory contains this sample program in the rtoday.ec file.

Output


INFORMIX-ESQL/C Programmer's Manual, Version 9.21
Copyright © 1999, Informix Software, Inc. All rights reserved