La traducción de esta página está obsoleta. Haga clic aquí para ver la última versión en inglés.

round

Redondear al decimal o entero más próximo

Sintaxis

Y = round(X)

Y = round(X,N)

Y = round(X,N,type)

Y = round(t)

Y = round(t,unit)

Descripción

Y = round(X) redondea cada elemento de X al entero más próximo. En caso de un empate en el que un elemento tenga una parte fraccionaria de exactamente 0.5, la función round redondea alejándose de cero hacia el entero de mayor magnitud.

Y = round(X,N) redondea a N dígitos:

• N > 0: redondea N dígitos a la derecha del separador decimal.

• N = 0: redondea al entero más próximo.

• N < 0: redondea N dígitos a la izquierda del separador decimal.

Y = round(X,N,type) especifica el tipo de redondeo. Especifique 'significant' para que redondee a N dígitos significativos (contados a partir del dígito de la izquierda del todo). En este caso, N debe ser un entero positivo.

Y = round(t) redondea cada elemento del arreglo duration t al número más próximo de segundos.

Y = round(t,unit) redondea cada elemento de t al número más próximo de la unidad de tiempo especificado.

Ejemplos

Redondear elementos de matriz

Redondee los elementos de una matriz de 2 por 2 al entero más próximo.

X = [2.11 3.5; -3.5 0.78];
Y = round(X)

Y = 2×2

     2     4
    -4     1

Redondear a un número especificado de dígitos decimales

Redondee pi a los 3 dígitos decimales más próximos.

Y = round(pi,3)

Y = 3.1420

Redondear al múltiplo más próximo de 100

Redondee el número 863178137 al múltiplo más próximo de 100.

round(863178137,-2)

ans = 863178100

Redondear elementos al número especificado de dígitos significativos

Redondee los elementos de un vector para que mantengan 2 dígitos significativos.

format shortg
x = [1253 1.345 120.44]

x = 1×3

    1.2530    0.0013    0.1204

y = round(x,2,'significant')

y = 1×3

    1.3000    0.0013    0.1200

Controlar la visualización de números al redondear

El comando format controla el modo en que MATLAB® muestra los números en la línea de comandos. Si un número tiene dígitos adicionales que no se pueden visualizar en el formato actual, MATLAB redondea automáticamente el número con fines de visualización. Esto puede provocar resultados imprevistos al combinarse con la función round.

Considere el resultado de la siguiente operación de resta, que muestra 5 dígitos.

format short
x = 112.05 - 110

x = 2.0500

Según el valor visualizado de x, al redondear x a 1 decimal se debe devolver 2.1.

round(x,1)

ans = 2

De hecho, el problema en este caso es que MATLAB redondea x a 5 dígitos con fines de visualización. La función round devuelve la respuesta correcta. Confirme la respuesta visualizando x con format long, lo que muestra x redondeado a 15 dígitos.

format long
x

x = 
   2.049999999999997

Redondear los valores de duración

Redondee cada valor de un arreglo de duración al número más próximo de segundos.

t = hours(8) + minutes(29:31) + seconds(1.3:0.5:2.3);
t.Format = 'hh:mm:ss.SS'

t = 1x3 duration
   08:29:01.30   08:30:01.80   08:31:02.30

Y1 = round(t)

Y1 = 1x3 duration
   08:29:01.00   08:30:02.00   08:31:02.00

Redondee cada valor de t al número más próximo de horas.

Y2 = round(t,'hours')

Y2 = 1x3 duration
   08:00:00.00   09:00:00.00   09:00:00.00

Argumentos de entrada

X — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional

Arreglo de entrada, especificado como escalar, vector, matriz o arreglo multidimensional. En el caso de X complejo, round trata las partes reales y las imaginarias de distinta forma.

X debe ser single o double cuando utilice round con más de una entrada.

round convierte elementos lógicos y char de X a valores double.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | logical
Soporte de números complejos: Sí

N — Número de dígitos

entero escalar

Número de dígitos, especificado como entero escalar. Cuando especifica N, la función round redondea X al múltiplo más próximo de 10 ^-N.

Si especifica el tipo de redondeo 'significant', N debe ser un entero positivo.

type — Tipo de redondeo

'decimals' (predeterminado) | 'significant'

Tipo de redondeo, especificado como 'decimals' o 'significant'. El tipo de redondeo determina si round considera los dígitos en relación con el separador decimal o el número global de dígitos significativos. N debe ser un entero positivo cuando especifica 'significant'. En ese caso, la función round redondea al número más próximo con N dígitos significativos.

El valor predeterminado es 'decimals', de forma que round(X,N,'decimals') equivalga a round(X,N).

Ejemplo: round(3132,2,'significant') devuelve 3100, que es el número más próximo a 3132 con 2 dígitos significativos.

Tipos de datos: char | string

t — Duración de entrada

arreglo de duration

Duración de entrada, especificada como arreglo de duration.

unit — Unidad de tiempo

'seconds' (predeterminado) | 'minutes' | 'hours' | 'days' | 'years'

Unidad de tiempo, especificada como 'seconds', 'minutes', 'hours', 'days' o 'years'. Una duración de 1 año equivale exactamente a 365,2425 días de 24 horas.

Tipos de datos: char | string

Sugerencias

• Tanto format short como format long muestran números redondeados. Esto puede provocar resultados imprevistos al combinarse con la función round.

• Con fines de visualización, utilice sprintf para controlar la visualización exacta de un número como cadena. Por ejemplo, para visualizar exactamente 2 dígitos decimales de pi (sin ceros posteriores), utilice sprintf('%.2f',pi).

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

Esta función es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• La generación de código solo es compatible con la sintaxis Y = round(X).

• La generación de código no es compatible con tipos de datos char o logical para X.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• La generación de código solo es compatible con la sintaxis Y = round(X).

• La generación de código no es compatible con tipos de datos char o logical para X.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Run MATLAB Functions in Thread-Based Environment.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Estas sintaxis no son compatibles:

  Y = round(X,N)

  Y = round(X,N,type)

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2014b: Redondear a un número especificado de dígitos

El comportamiento cambió en R2014b

En la versión R2014b, se añadieron estas sintaxis para redondear a cualquier número decimal o de dígitos significativos y para redondear valores de duración:

Y = round(X,N)
Y = round(X,N,type)
Y = round(t)  
Y = round(t,unit)   

Las versiones más antiguas de MATLAB^® solo son compatibles con esta sintaxis, que redondea al entero más próximo:

Y = round(X) 

Consulte también

ceil | fix | floor

Temas

• Integers
• Floating-Point Numbers

×

Abrir ejemplo

Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?

No, sobrescribir la versión modificada Sí