Int8.From

La función Int8.From devuelve un número entero de 8 bits con signo a partir de un valor.

Sintaxis

Int8.From(
    value as any,
    optional culture as nullable text,
    optional roundingMode as nullable number
) as nullable number

Parámetros
  • value: valor a convertir
  • culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar
  • roundingMode: (opcional) modo de redondeo
Información adicional

value deberá representar un número (entero o real) mayor o igual a -128,5 y menor que 127,5. Si se trata de un número entero, la función devuelve el mismo número. Si es un número real con parte fraccionaria no nula, se redondea según el criterio que se indique (por defecto se aplica el criterio RoundingMode.ToEven). Si value es de otro tipo, se intenta convertir a número según los criterios determinados por la función Number.FromText, devolviéndose un error en el caso de que esta conversión no sea posible.

Por último, si value es un NULL, la función también devuelve un NULL.

Véase en Number.Round información sobre el redondeo.

Ejemplos

El número a convertir deberá ser menor estricto que 127,5:

Int8.From(127.4999999)

127

Función Int8.From

El intento de convertir el número 127.5 ya devuelve un error:

Int8.From(127.5)

Error

Función Int8.From

En este ejemplo estamos convirtiendo el texto "15.5". Observamos varias cosas: es necesario especificar el parámetro culture para que la función interprete correctamente el separador decimal (el equipo usado tiene una configuración de español-España). En segundo lugar, el valor numérico se redondea, por defecto, hacia el entero par más próximo -en este caso el número 16-:

Int8.From("15.5", "en-us")

16

Función Int8.From
Categoría
Funciones numéricas
Submitted by admin on Tue, 03/31/2020 - 09:52