CHAR9 función escalar

La función CHAR9 devuelve una representación de serie de caracteres de longitud fija del argumento. La función " CHAR9 " está pensada para ser compatible con versiones anteriores de " Db2 for z/OS® " que dependen del formato de resultado que se devuelve para valores de entrada decimales en la versión 9 y anteriores.

Importante : Para aplicaciones portátiles que puedan ejecutarse en plataformas distintas de Db2 para z/OS, utilice la función CHAR en su lugar. Otros productos de la familia de e Db2 s no son compatibles con la función de e CHAR9.

El primer argumento puede ser cualquier valor de los siguientes tipos:

  • número entero
  • Número decimal
  • número de coma flotante
  • número decimal de coma flotante
  • Serie de caracteres
  • Serie gráfica
  • valor de fecha y hora
  • Valor de ID de fila

Si el primer argumento es un número decimal, el resultado se formatea como se indica en la siguiente descripción. Sin embargo, si el primer argumento no es un número decimal, el resultado es idéntico al resultado de la función CHAR.

Decimal a carácter:

Leer diagrama de sintaxisOmitir el diagrama de sintaxis visualCHAR9( expresión decimal,carácter decimal)
Decimal a Carácter
expresión decimal
Expresión que devuelve un valor que es un tipo de datos decimal integrado. Para especificar una precisión y escala diferentes para el valor de la expresión, aplique la función DECIMAL antes de aplicar la función CHAR9.
carácter decimal
Especifica la constante de caracteres de un byte (CHAR o VARCHAR) que delimita los dígitos decimales en la cadena de caracteres resultante. El carácter no debe ser un dígito, un signo más (+), un signo menos (-) o un espacio en blanco. El valor predeterminado es el punto (.) o la coma (,). Para obtener información sobre los factores que rigen la elección, consulte Representación del punto decimal

El resultado es la representación de la cadena de caracteres de longitud fija del argumento. El resultado incluye un carácter decimal y hasta p dígitos, donde p es la precisión de la expresión decimal con el signo menos precedente si el argumento es negativo. Se devuelven los ceros iniciales y finales, y se devuelve un espacio en blanco inicial para un valor decimal positivo. El resultado incluye un carácter decimal, incluso si la escala de la expresión decimal es cero. Si el número de bytes del resultado es inferior a la longitud definida del resultado, el resultado se rellena a la derecha con espacios en blanco.

La longitud del resultado es 2 + p, donde p es la precisión de la expresión decimal.

El atributo de longitud del resultado es 2+p, donde p es la precisión de la expresión decimal.

La longitud real del resultado es el número menor de caracteres que se puede utilizar para representar el resultado, salvo que los ceros finales se incluyen. Si el argumento es negativo, el resultado comienza con un signo menos. De lo contrario, el resultado comienza con un dígito. Si la escala de la expresión decimal es cero, no se devuelve el carácter decimal.

El CCSID del resultado se determina a partir del contexto en el que se invocó la función. Para más información, véase Esquema de codificación y reglas CCSID para cadenas.

ejemplos

La siguiente tabla muestra la diferencia entre los resultados de las funciones CHAR y CHAR9, por ejemplo, argumentos de números decimales.

Tabla 1. Ejemplo de resultados de las funciones CHAR y CHAR9
Argumento decimal Resultado de la función CHAR CHAR9 resultado de la función
(000.1) '.1 ' ' 000.1'
(1000) '1000 ' ' 1000.'
(1.1) '1.1 ' ' 1.1'