La función Int8.From devuelve un número entero de 8 bits con signo a partir de un valor.
Int8.From(
value as any,
optional culture as nullable text,
optional roundingMode as nullable number
) as nullable number
- value: valor a convertir
- culture: (opcional) cadena de texto con información sobre la configuración regional a aplicar
- roundingMode: (opcional) modo de redondeo
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.
El número a convertir deberá ser menor estricto que 127,5:
Int8.From(127.4999999)
127
El intento de convertir el número 127.5 ya devuelve un error:
Int8.From(127.5)
Error
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
