Función escalar ROUND

Si expresión-numérica-1 es un valor positivo, un dígito con el valor 5 o un valor superior indica que se redondeará al número positivo siguiente. Por ejemplo, ROUND(3.5,0) = 4. Si expresión-numérica-1 es un valor negativo, un dígito con el valor 5 o superior es una indicación para redondear al número negativo anterior. Por ejemplo, ROUND(-3.5,0) = -4.

numeric-expression1

Una expresión que debe devolver un valor que sea un tipo de datos numérico o CHAR, VARCHAR, GRAPHIC o VARGRAPHIC incorporado. Si el valor no es un tipo de datos numérico, se convierte de forma implícita en DECFLOAT(34) antes de evaluar la función.

Si la expresión es un tipo de datos de coma flotante decimal, la modalidad de redondeo DECFLOAT no se utilizará. El comportamiento de redondeo de ROUND corresponde a un valor de ROUND_HALF_UP. Si se desea otro comportamiento de redondeo, utilice la función QUANTIZE.

numeric-expression2

Expresión que devuelve un valor que es un tipo de datos numérico incorporado. Si el valor no es del tipo INTEGER, se convierte de forma implícita en INTEGER antes de evaluar la función.

Si expresión-numérica-2 no es negativa, expresión-numérica-1 se redondea al valor absoluto de expresión-numérica-2 posiciones a la derecha de la coma decimal.

Si expresión-numérica-2 es negativa, expresión-numérica-1 se redondea al valor absoluto de expresión-numérica-2+1 número de posiciones a la izquierda de la coma decimal.

Si el valor absoluto de una expresión-numérica2 negativa es mayor que el número de dígitos a la izquierda del separador decimal, el resultado es 0. Por ejemplo, ROUND(748,58,-4) = 0. Si numeric-expression1 es positivo, un valor de dígito de 5 se redondea al siguiente número positivo más alto. Si expresión-numérica-1 es un valor negativo, un dígito con el valor 5 se redondeará al número negativo anterior.

El tipo de datos y el atributo de longitud del resultado coinciden con el tipo de datos y el atributo de longitud del primer argumento, con la excepción de que la precisión aumenta en uno si expresión-numérica-1 es DECIMAL y la precisión es menor que 31. Por ejemplo, un argumento con un tipo de datos de DECIMAL(5,2) da como resultado DECIMAL(6,2). Un argumento con un tipo de datos de DECIMAL(31,2) da como resultado DECIMAL(31,2). La escala es igual que la escala del primer argumento.

Si cualquiera de los argumentos puede ser nulo o si el argumento no es un número de coma flotante decimal y la base de datos se ha configurado con dft_sqlmathwarn establecido en YES, el resultado puede ser nulo. Si cualquiera de los argumentos es nulo, el resultado es el valor nulo.

Esta función no queda afectada por el valor del registro especial CURRENT DECFLOAT ROUNDING MODE, incluso para argumentos de coma flotante decimal. El comportamiento de redondeo de ROUND corresponde a un valor de ROUND_HALF_UP. Si para un valor de coma flotante decimal desea un comportamiento que se ajuste a la modalidad de redondeo especificada por el registro especial CURRENT DECFLOAT ROUNDING MODE, utilice la función QUANTIZE en su lugar.

expresión-fecha-hora

Una expresión que debe devolver un valor que sea una fecha, una hora o una indicación de fecha y hora. Las representaciones de serie de estos tipos de datos no reciben soporte y deben convertirse explícitamente en un valor DATE, TIME o TIMESTAMP para poder utilizarlas con esta función; de forma alternativa, puede utilizar la función ROUND_TIMESTAMP para una representación de serie de una fecha o indicación de fecha y hora.

serie-formato

Una expresión que devuelve un tipo de datos de serie de caracteres incorporado con una longitud real que no es superior a 255 bytes. El elemento de formato de serie-formato especifica cómo debe redondearse expresión-fecha-hora. Por ejemplo, si serie-formato es 'DD', una indicación de fecha y hora que se represente mediante una expresión-fecha-hora se redondea al día más cercano. Los espacios en blanco iniciales y finales se eliminan de la serie y la subserie resultante debe ser un elemento de formato válido para el tipo de expresión-fecha-hora (SQLSTATE 22007). El valor predeterminado es 'DD', que no se puede utilizar si el tipo de datos de expresión-fecha-hora es TIME.

Los valores permitidos para serie-formato se listan en la tabla de elementos de formato listados en la Tabla 1.

nombre-entorno-local

Constante de caracteres que especifica el entorno local que se utiliza para determinar el primer día de la semana cuando se utilizan valores de elemento de formato DAY, DY o D. El valor de nombre-entorno-local no es sensible a las mayúsculas y minúsculas y debe ser un entorno local válido (SQLSTATE 42815). Para obtener información sobre los entornos locales válidos y sus nombres, consulte la sección Nombres de entorno local para SQL y XQuery. Si no se especifica nombre-entorno-local, se utiliza el valor del registro especial CURRENT LOCALE LC_TIME.

Los elementos de formato siguientes se utilizan para identificar la unidad de redondeo o truncamiento del valor de fecha y hora en las funciones ROUND, ROUND_TIMESTAMP, TRUNCATE y TRUNC_TIMESTAMP.

Si para un argumento de fecha se especifica un elemento de formato que se aplica a la parte de hora de un valor, el argumento de fecha se devuelve sin cambios. Si para un argumento de hora se especifica un elemento de formato que no es válido para este tipo de argumento, se devuelve un error (SQLSTATE 22007).