C#のDecimal.ToSByte()メソッドとは？構文と使い方をわかりやすく解説

C#のDecimal.ToSByte()メソッドは、指定されたDecimal（10進数）の値を、それと等価な8ビット符号付き整数（sbyte型）に変換するために使用される静的メソッドです。小数を含む値を整数として扱いたい場合などに活用できます。

構文

このメソッドの構文は以下の通りです。

public static sbyte ToSByte (decimal val);

パラメータの「val」には、変換対象となるdecimal型の数値を指定します。戻り値としては、変換後のsbyte型（-128〜127の範囲）の値が返されます。

使用例1：基本的な使い方

まずは、Decimal.ToSByte()メソッドを使った基本的なサンプルコードを見てみましょう。

using System;
public class Demo {
    public static void Main(){
        Decimal val = 97.567m;
        Console.WriteLine("Decimal value = " + val);
        sbyte res = Decimal.ToSByte(val);
        Console.WriteLine("SByte value = " + res);
    }
}

出力結果

このプログラムを実行すると、以下のように出力されます。

Decimal value = 97.567
SByte value = 97

ご覧のとおり、小数点以下の値（.567）は切り捨てられ、整数部分の「97」だけがsbyte型として返されています。

使用例2：0に近い小数の場合

続いて、別の例を確認してみましょう。ここでは「0.001」という小さな値を変換しています。

using System;
public class Demo {
    public static void Main(){
        Decimal val = 0.001m;
        Console.WriteLine("Decimal value = " + val);
        sbyte res = Decimal.ToSByte(val);
        Console.WriteLine("SByte value = " + res);
    }
}

出力結果

実行結果は以下のようになります。

Decimal value = 0.001
SByte value = 0

このように、0.001という小数も切り捨てられて「0」に変換されることがわかります。

注意点

Decimal.ToSByte()メソッドを使用する際には、以下のポイントに注意しましょう。

• 範囲外の値で例外が発生： 変換元の値がsbyte型の範囲（-128〜127）を超える場合、OverflowExceptionがスローされます。
• 小数は切り捨てられる： 小数点以下は四捨五入ではなく切り捨てられます。負の値の場合も同様に、0に近い方向へ切り捨てられます。
• nullは指定できない： decimalは値型であるため、引数にnullを渡すことはできません。

範囲外の値が入力される可能性がある場合は、事前に値のチェックを行うか、try-catchブロックでOverflowExceptionを適切に処理することをおすすめします。