The mi_interval_to_string() function
The mi_interval_to_string() function creates an ANSI SQL standards text (string) representation of an interval value from its binary (internal) INTERVAL representation.
Syntax
mi_string *mi_interval_to_string(intvl_data)
mi_interval *intvl_data;- intvl_data
- A pointer to the internal INTERVAL representation of the interval value.
| Valid in client LIBMI application? | Valid in user-defined routine? |
|---|---|
| Yes | Yes |
Usage
The mi_interval_to_string() function
converts the internal INTERVAL value that intvl_data references
into an interval string. The interval string has the following ANSI
SQL standards format:
"YYYY-MM-DD HH:mm:SS.FFFFF"- YYYY
- The 4-digit year.
- MM
- The 2-digit month.
- DD
- The 2-digit day.
- HH
- The 2-digit hour.
- mm
- The 2-digit minute.
- SS
- The 2-digit second.
- FFFFF
- The fraction of a second, in which the date, time, or date and time qualifier specifies the number of digits, with a maximum precision of 5 digits.
If the internal INTERVAL value contains only
a subset of this range, mi_interval_to_string() creates
an interval string with the appropriate portion of the preceding format.
For example, suppose intvl_data references the internal format
of the interval 6 days, 5 hours, and 45 minutes. The mi_interval_to_string() function
returns an mi_string value with the following interval string:
"06 05:45"For GLS, the mi_interval_to_string() function does not format the interval string in the date and time formats of the current processing locale.
For more information about how to convert internal INTERVAL format to interval strings, see the Informix® DataBlade® API Programmer's Guide.
Return values
- An mi_string pointer
- A pointer to the interval string equivalent to intvl_data.
- NULL
- The function was not successful.