DateTime.AddSeconds(Double) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

DateTime.cs

このインスタンスの値に、指定された秒数を加算した新しい DateTime を返します。

C#

public DateTime AddSeconds(double value);

パラメーター

value

Double

整数部と小数部から成る秒数。 value パラメーターは、正または負のどちらの場合もあります。

戻り値

DateTime

このインスタンスで表された日付と時刻に value で表された秒数を加算した値を保持するオブジェクト。

例外

ArgumentOutOfRangeException

結果 DateTime が DateTime.MinValue より小さいか、 DateTime.MaxValue より大きくなります。

例

次の例では、 メソッドを AddSeconds 使用して 30 秒と 1 日の秒数を DateTime 値に追加します。 その後、新しい各値が表示され、その値と元の値の差が表示されます。 差は、期間とティック数の両方として表示されます。

C#

using System;

public class Example
{
   public static void Main()
   {
      string dateFormat = "MM/dd/yyyy hh:mm:ss";
      DateTime date1 = new DateTime(2014, 9, 8, 16, 0, 0);
      Console.WriteLine("Original date: {0} ({1:N0} ticks)\n",
                        date1.ToString(dateFormat), date1.Ticks);

      DateTime date2 = date1.AddSeconds(30);
      Console.WriteLine("Second date:   {0} ({1:N0} ticks)",
                        date2.ToString(dateFormat), date2.Ticks);
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)\n",
                        date2 - date1, date2.Ticks - date1.Ticks);

      // Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      DateTime date3 = date1.AddSeconds(60 * 60 * 24);
      Console.WriteLine("Third date:    {0} ({1:N0} ticks)",
                        date3.ToString(dateFormat), date3.Ticks);
      Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)",
                        date3 - date1, date3.Ticks - date1.Ticks);
   }
}
// The example displays the following output:
//    Original date: 09/08/2014 04:00:00 (635,457,888,000,000,000 ticks)
//
//    Second date:   09/08/2014 04:00:30 (635,457,888,300,000,000 ticks)
//    Difference between dates: 00:00:30 (300,000,000 ticks)
//
//    Third date:    09/09/2014 04:00:00 (635,458,752,000,000,000 ticks)
//    Difference between dates: 1.00:00:00 (864,000,000,000 ticks)

注釈

このメソッドでは、この DateTimeの値は変更されません。 代わりに、この操作の結果である値を持つ新しい DateTime が返されます。

の value 小数部は、秒の小数部です。 たとえば、4.5 は 4 秒、500 ミリ秒、0 ティックに相当します。

.NET 6 以前のバージョンでは、 value パラメーターは最も近いミリ秒に丸められます。 .NET 7 以降のバージョンでは、 パラメーターのvalue完全なDouble有効桁数が使用されます。 ただし、浮動小数点演算の本質的な不正確さが原因で、結果の精度は異なります。

適用対象

こちらもご覧ください

• Double
• 日付と時刻を使用した算術演算の実行