AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Personaliza el formato de un número.
Formato
@DTW_FORMAT(número, antes, después, expp, expt, precisión, resultado)
@DTW_FORMAT(número, antes, después, expp, expt, resultado)
@DTW_FORMAT(número, antes, después, expp, resultado)
@DTW_FORMAT(número, antes, después, resultado)
@DTW_FORMAT(número, antes, resultado)
@DTW_FORMAT(número, resultado)
@DTW_rFORMAT(número, antes, después, expp, expt, precisión)
@DTW_rFORMAT(número, antes, después, expp, expt)
@DTW_rFORMAT(número, antes, después, expp)
@DTW_rFORMAT(número, antes, después)
@DTW_rFORMAT(número, antes)
@DTW_rFORMAT(número)
Parámetros
Tabla 67. Parámetros de DTW_FORMAT
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
flotante | número | IN | Variable o serie literal que representa un número. |
entero | antes | IN | Variable o serie literal que representa un número entero positivo. Es un parámetro opcional. Debe escribir una serie nula ("") para disponer de parámetros adicionales. |
entero | después | IN | Variable o serie literal que representa un número entero positivo. Es un parámetro opcional. Debe escribir una serie nula ("") para especificar caracteres adicionales. |
entero | expp | IN | Variable o serie literal que representa un número entero positivo. Debe especificar una serie nula ("") para especificar parámetros adicionales. |
entero | expt | IN | Variable o serie literal que representa un número entero positivo. Debe escribir una serie nula ("") para especificar caracteres adicionales. |
entero | precisión | IN | Variable o serie literal que representa un número entero positivo que especifica la precisión del resultado. El valor por omisión es 9. |
flotante | resultado | OUT | Variable que contiene el número con el formato y redondeo especificados. |
Códigos de retorno
Tabla 68. Códigos de retorno de DTW_FORMAT
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
1001 | Un parámetro de entrada contenía un valor NULL. |
1002 | Un parámetro de entrada contenía un valor de serie que consistía en el carácter de terminación nulo. |
1003 | Se ha transmitido un número incorrecto de parámetros en una llamada de función. |
1005 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente. |
1006 | Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida. |
4000 | Un parámetro contiene un valor de número entero no válido. |
4001 | Un parámetro contiene un valor de número no válido. |
Notas de utilización
Ejemplos
Ejemplo 1:
@DTW_FORMAT(NUM, BEFORE, result)
Ejemplo 2:
@DTW_FORMAT("1.73", "4", "0", result)
Ejemplo 3:
@DTW_FORMAT("1.73", "4", "3", result)
Ejemplo 4:
@DTW_FORMAT(" - 12.73", "", "4", result)
Ejemplo 5:
@DTW_FORMAT("12345.73", "", "", "2", "2", result)
Ejemplo 6:
@DTW_FORMAT("1.234573", "", "3", "", "0", result)
Ejemplo 7:
@DTW_rFORMAT(" - 12.73")
Ejemplo 8:
@DTW_rFORMAT("0.000")
Ejemplo 9:
@DTW_rFORMAT("12345.73", "", "", "3", "6")
Ejemplo 10:
@DTW_rFORMAT("1234567e5", "", "3", "0")
Ejemplo 11:
@DTW_rFORMAT("12345.73", "", "3", "", "0")