DateTime.AddSeconds(Double) DateTime.AddSeconds(Double) DateTime.AddSeconds(Double) DateTime.AddSeconds(Double) Method

定義

このインスタンスの値に、指定された秒数を加算した新しい DateTime を返します。Returns a new DateTime that adds the specified number of seconds to the value of this instance.

public:
 DateTime AddSeconds(double value);
public DateTime AddSeconds (double value);
member this.AddSeconds : double -> DateTime
Public Function AddSeconds (value As Double) As DateTime

パラメーター

value
Double Double Double Double

整数部と小数部から成る秒数。A number of whole and fractional seconds. value パラメーターは、正または負のどちらの場合もあります。The value parameter can be negative or positive.

戻り値

このインスタンスで表された日付と時刻に value で表された秒数を加算した値を保持するオブジェクト。An object whose value is the sum of the date and time represented by this instance and the number of seconds represented by value.

例外

結果として返された DateTimeMinValue より小さいか、MaxValue より大きいです。The resulting DateTime is less than MinValue or greater than MaxValue.

次の例ではAddSeconds 、メソッドを使用して、1日のDateTime値に30秒と秒数を加算します。The following example uses the AddSeconds method to add 30 seconds and the number of seconds in one day to a DateTime value. その後、それぞれの新しい値が表示され、その値と元の値の差が表示されます。It then displays each new value and displays the difference between it and the original value. 差は、時間間隔とタイマー刻みの数の両方として表示されます。The difference is displayed both as a time span and as a number of ticks.

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)
Module Example
   Public Sub Main()
      Dim dateFormat As String = "MM/dd/yyyy hh:mm:ss"
      Dim date1 As Date = #09/08/2014 16:00#
      Console.WriteLine("Original date: {0} ({1:N0} ticks)", _
                        date1.ToString(dateFormat), date1.Ticks)
      Console.WriteLine()
      
      Dim date2 As Date = 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)", _
                        date2 - date1, date2.Ticks - date1.Ticks)                        
      Console.WriteLine()
      
      ' Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      Dim date3 As Date = 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)                        
   End Sub
End Module
' 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の値を変更しません。This method does not change the value of this DateTime. 代わりに、この操作の結果DateTimeを値として持つ新しいを返します。Instead, it returns a new DateTime whose value is the result of this operation.

value小数部は、秒の小数部です。The fractional part of value is the fractional part of a second. たとえば、4.5 は、4秒、500ミリ秒、および0ティックに相当します。For example, 4.5 is equivalent to 4 seconds, 500 milliseconds, and 0 ticks.

valueパラメーターは、ミリ秒単位で丸められます。The value parameter is rounded to the nearest millisecond.

適用対象

こちらもご覧ください