Skip to main content

Byte.From

Creates an 8-bit integer from the given value.

Syntax​

Byte.From(
    value as any,
    optional culture as text,
    optional roundingMode as RoundingMode.Type
) as number

Remarks​

Returns an 8-bit integer number value from the given value. If the given value is null, Byte.From returns null. If the given value is a number within the range of an 8-bit integer without a fractional part, value is returned. If it has fractional part, then the number is rounded with the rounding mode specified. The default rounding mode is RoundingMode.ToEven. If value is of any other type, it will first be converted to a number using Number.FromText. Refer to Number.Round for the available rounding modes. An optional culture may also be provided (for example, "en-US").

Examples​

Example #1​

Get the 8-bit integer <code>number</code> value of <code>"4"</code>.

Byte.From("4")

Result:

4

Example #2​

Get the 8-bit integer <code>number</code> value of <code>"4.5"</code> using <code>RoundingMode.AwayFromZero</code>.

Byte.From("4.5", null, RoundingMode.AwayFromZero)

Result:

5

Category​

Number.Conversion and formatting