Manual de consulta

DTW_FORMAT


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

  1. Si número es el único parámetro especificado, se da formato al resultado como si se hubiera ejecutado @DTW_rADD(número,"0").
  2. Los parámetros antes y después describen el número de caracteres que se utilizan para las partes de enteros y decimales del parámetro resultado, respectivamente. Si omite uno de estos parámetros o los dos, se utilizan tantos caracteres para esa parte como sean necesarios.
  3. Si el parámetro antes no es lo suficientemente grande como para que contenga la parte entera del número (más el signo en los números negativos), se produce un error. Si el parámetro antes es más grande que el que se necesita para dicha parte, el valor del parámetro número se rellena con blancos a la izquierda. Si el parámetro después no tiene el mismo tamaño que la parte decimal del parámetro número, el número se redondea (o se amplía con ceros) para que quepa. Especificar 0 hace que el número se redondee a un entero.
  4. Los parámetros expp y expt controlan la parte exponencial del resultado. El parámetro expp establece el número de espacios para la parte exponencial; el valor por omisión es utilizar tantos como sea necesario (que puede ser cero). El parámetro expt establece el punto desencadenante de la utilización de la notación exponencial. El valor por omisión es el valor por omisión del parámetro de precisión.
  5. Si expp es 0, no se proporciona ningún exponente y el número se expresa en un formato simple añadiendo los ceros que sean necesarios. Si expp no es lo suficientemente grande para que contenga el exponente, se produce un error.
  6. Si el número de espacios necesarios para la parte entera o decimal supera a expt o a dos veces expt, respectivamente, utilice la notación exponencial. Si expt es 0, siempre se utiliza la notación exponencial a menos que el exponente sea 0. (Si expp es 0, este valor prevalece sobre un valor de 0 de expt.) Si el exponente es 0 cuando se especifica un valor de expp diferente a cero, se proporcionan expp+2 blancos para la parte exponencial del resultado. Si el exponente es 0 y no se especifica expp, se utiliza el formato simple.

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")


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]