# OCONV
Updated: 10/19/2021, 9:29:48 PM
Created: 10/19/2021, 9:29:48 PM
Last Updated By: Kevin Munoz
Read Time: 4 minute(s)
Tags: case lower upper lower case to upper case upper case to lower case output formatting
# Description
Use the OCONV statement to convert internal representations of data to their external form. The statement takes the general form:
OCONV(expression1, expression2)
Where expression1 may evaluate to any data type but must be relevant to the conversion code. expression2 should evaluate to a conversion code from the list below.
Alternatively, expression2 may evaluate to a user exit known to the jBASE BASIC language or supplied by the user.
# International Mode
Description of date, time, number and currency conversions same as when used in ICONV and International Mode
# Note
OCONV will return the result of the conversion of expression1 by expression2.
Shown below are valid conversion codes:
| Conversion | Action |
|---|---|
| D{n{c}} | Converts an internal date to an external date format. The numeric argument n specifies the field width allowed for the year and can be 0 to 4 (default 4). The character c causes the date to be return in the form ddcmmcyyyy. If it is not specified the month name is return in abbreviated form. |
| DI | Allow the conversion of an external date to the internal format even though an output conversion is expected. |
| DD | Returns the day in the current month. |
| DM | Returns the number of the month in the year. |
| DMA | Returns the name of the current month. |
| DJ | Returns the number of the day in the year (0-366). |
| DQ | Returns the quarter of the year as a number 1 to 4 |
| DW | Returns the day of the week as a number 1 to 7 (Monday is 1). |
| DWA | Returns the name of the day of the week. |
| DY{n} | Returns the year in a field of n characters. |
| F | Given a prospective filename for a command such as CREATE-FILE this conversion will return a filename that is acceptable to the version of UNIX jBASE is running on. |
| MCA | Removes all but the alphabetic characters from the input string. |
| MC/A | Removes all but the non-alphabetic characters in the input string. |
| MCB | Returns just the alphabetic and numeric characters from the input string |
| MCN | Removes all but the numeric characters from the input string |
| MC/N | Removes all but the non-numeric characters from the input string |
| MC/B | Remove all alphabetic and numeric characters from their input string. |
| MCC;s1;s2 | Replaces all occurrences of string s1 with string s2 |
| MCL | Converts all upper case characters in the string to lower case characters |
| MCU | Converts all lower case characters in the string to upper case characters. |
| MCT | Capitalizes each word in the input string; e.g. JIM converts to Jim |
| MCP{c} | Converts all non-printable characters to a period character "." in the input string. When supplied use the character "c" in place of the period. |
| MCPN{n} | In the same manner as the MCP conversion, it replaces all non-printable characters. The ASCII hexadecimal value follows the replacing character. |
| MCNP{n} | Performs the opposite conversion to MCPN. The ASCII hexadecimal value following the tilde character converts to its original binary character value. |
| MCDX | Converts the decimal value in the input string to its hexadecimal equivalent. |
| MCXD | Converts the hexadecimal value in the input string to its decimal equivalent. |
| Gncx | Extracts x groups separated by character c skipping n groups, from the input string. |
| MT{HS} | Performs time conversions. |
| MD | Converts the supplied integer value to a decimal value. |
| MP | Converts a packed decimal number to an integer value. |
| MX | Converts ASCII input to hexadecimal characters. |
| T | Performs file translations given a cross-reference table in a record in a file. |
Go back to jBASE BASIC
Go back to Programmers' Reference Guide