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

C#の DateTime.AddTicks() メソッドは、現在の日時（DateTimeインスタンス）に指定したティック数を加算するためのメソッドです。このメソッドは元の値を変更せず、計算結果として新しい DateTime オブジェクトを返します。

構文

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

public DateTime AddTicks (long ticks);

引数 ticks には加算したいティック数を long 型で指定します。1ティックは100ナノ秒に相当します。なお、負の値を指定すると日時を過去方向へ移動させることができます。

使用例1：ティックを加算する場合

まずは、正の値を指定してティックを加算する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        DateTime d1 = new DateTime(2019, 07, 25, 6, 20, 40);
        DateTime d2 = d1.AddTicks(5000);
        System.Console.WriteLine("DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d1);
        System.Console.WriteLine("Initial Ticks = {0} ", d1.Ticks);
        System.Console.WriteLine("New Ticks = {0} ", d2.Ticks);
    }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

DateTime = 25 July 2019, 06:20:40
Initial Ticks = 636996324400000000
New Ticks = 636996324400005000

実行結果から、5000ティック（0.5ミリ秒）が加算され、新しい Ticks の値が「636996324400005000」になっていることが確認できます。

使用例2：負の値でティックを減算する場合

続いて、負の値を指定してティックを減算する例です。AddTicks() にマイナスの値を渡すことで、日時を過去へ戻すことができます。

using System;
public class Demo {
    public static void Main(){
        DateTime d1 = new DateTime(2019, 07, 25, 6, 20, 40);
        DateTime d2 = d1.AddTicks(-5000);
        System.Console.WriteLine("DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d1);
        System.Console.WriteLine("Initial Ticks = {0} ", d1.Ticks);
        System.Console.WriteLine("New Ticks (subtracting) = {0} ", d2.Ticks);
    }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

DateTime = 25 July 2019, 06:20:40
Initial Ticks = 636996324400000000
New Ticks = 636996324399995000

今回は -5000 を指定しているため、元の Ticks の値から5000が減算され、「636996324399995000」という結果になりました。

ポイントまとめ

• AddTicks() メソッドは、指定したティック数（100ナノ秒単位）を日時に加算する。
• 元の DateTime インスタンスは変更されず、新しいインスタンスが返される（イミュータブル）。
• 負の値を指定すれば、日時を過去方向に移動できる。
• 高精度な時間計算が必要な場面（パフォーマンス測定など）で活用できる。