メインコンテンツまでスキップ

Byte.From

指定された値から 8 ビット整数を作成します。

Syntax​

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

Remarks​

指定された value から 8 ビット整数の number 値を返します。指定された value が null である場合、Byte.From は null を返します。指定された value が 8 ビット整数の範囲内の number で、小数部がない場合には、value が返されます。小数部がある場合には、指定されている端数処理モードで数値が端数処理されます。既定の端数処理モードは RoundingMode.ToEven です。value がそれ以外の型である場合には、Number.FromText を使用して number 値に変換されます。利用可能な端数処理モードについては、Number.Round をご覧ください。省略可能な culture を指定することもできます (例: "en-US")。

Examples​

Example #1​

<code>"4"</code> の 8 ビット整数 <code>number</code> 値を取得します。

Byte.From("4")

Result:

4

Example #2​

<code>RoundingMode.AwayFromZero</code> を使用して、<code>"4.5"</code> の 8 ビット整数 <code>number</code> 値を取得します。

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

Result:

5

Category​

Number.Conversion and formatting