【C#】Decimal.ToUInt32()メソッドの使い方を解説

概要

C#のDecimal.ToUInt32()メソッドは、指定されたDecimal型（10進数）の値を、それと等価な32ビット符号なし整数（uint）に変換するために使用されます。小数点以下の値は切り捨てられます。

構文

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

public static uint ToUInt32(decimal val);

パラメータ「val」には、変換対象となるdecimal型の数値を指定します。

戻り値と例外

戻り値は、valと等価な32ビット符号なし整数（uint）です。小数部分は切り捨てられます。なお、valが負の値である場合や、UInt32.MaxValue（4,294,967,295）を超える場合には、OverflowExceptionがスローされる点に注意してください。

使用例1

まずは基本的な使用例を見てみましょう。

using System;
public class Demo {
   public static void Main(){
      Decimal val = 0.001m;
      Console.WriteLine("Decimal value = "+val);
      uint res = Decimal.ToUInt32(val);
      Console.WriteLine("32-bit unsigned integer = "+res);
   }
}

出力

上記のコードを実行すると、次のような結果が表示されます。

Decimal value = 0.001
32-bit unsigned integer = 0

使用例2

続いて、別の例も確認してみましょう。

using System;
public class Demo {
   public static void Main(){
      Decimal val = 67.487m;
      Console.WriteLine("Decimal value = "+val);
      uint res = Decimal.ToUInt32(val);
      Console.WriteLine("32-bit unsigned integer = "+res);
   }
}

出力

実行結果は以下のとおりです。

Decimal value = 67.487
32-bit unsigned integer = 67

このように、Decimal.ToUInt32()メソッドでは小数点以下が切り捨てられ、整数部分のみが32ビット符号なし整数として返されることが確認できます。