Share via


Byte.From

Syntax

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

About

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").

Example 1

Get the 8-bit integer number value of "4".

Usage

Byte.From("4")

Output

4

Example 2

Get the 8-bit integer number value of "4.5" using RoundingMode.AwayFromZero.

Usage

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

Output

5