C#のDateTimeOffset.FromUnixTimeMilliseconds()メソッドの使い方を解説

C#のDateTimeOffset.FromUnixTimeMilliseconds()メソッドは、1970年1月1日午前0時0分0秒(UTC)からの経過時間をミリ秒単位で表したUnix時間を、DateTimeOffset型の値に変換するために使用されます。

構文

構文は以下のとおりです −

public static DateTimeOffset FromUnixTimeMilliseconds (long val);

上記のvalには、1970年1月1日午前0時0分0秒(UTC、協定世界時)から経過したミリ秒数を指定します。

使用例1

まずは、DateTimeOffset.FromUnixTimeMilliseconds()メソッドを実装した基本的な例を見てみましょう −

using System;
public class Demo {
   public static void Main() {
      DateTimeOffset offset = DateTimeOffset.FromUnixTimeMilliseconds(30000);
      Console.WriteLine("DateTimeOffset = {0} ",offset);
      Console.WriteLine("DateTimeOffset (other format) = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ",offset);
   }
}

出力

上記のコードを実行すると、以下の出力が得られます −

DateTimeOffset = 1/1/1970 12:00:30 AM +00:00
DateTimeOffset (other format) = 01 January 1970, 12:00:30

使用例2

次に、引数に0を指定した場合の例を見てみましょう。Unixエポック(1970年1月1日午前0時0分0秒)そのものが返されることを確認できます −

using System;
public class Demo {
   public static void Main() {
      DateTimeOffset offset = DateTimeOffset.FromUnixTimeMilliseconds(0);
      Console.WriteLine("DateTimeOffset = {0} ",offset);
      Console.WriteLine("DateTimeOffset (other format) = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ",offset);
   }
}

出力

上記のコードを実行すると、以下の出力が得られます −

DateTimeOffset = 1/1/1970 12:00:00 AM +00:00
DateTimeOffset (other format) = 01 January 1970, 12:00:00

ポイント

このメソッドは静的メソッドであり、戻り値のDateTimeOffsetのオフセットは常に+00:00(UTC)になります。ローカル時刻に変換したい場合は、戻り値に対してToLocalTime()メソッドを使用してください。また、引数にはUnixエポックから±約292年分の範囲内のミリ秒数を指定する必要があります。