Calendar.AddSeconds(DateTime, Int32) メソッド

定義

名前空間:

System.Globalization

アセンブリ:

System.Runtime.dll

ソース:

Calendar.cs

指定した DateTime から指定した秒数が経過した後の DateTime を返します。

C#

public virtual DateTime AddSeconds (DateTime time, int seconds);

パラメーター

time

DateTime

秒数を加算する対象の DateTime。

seconds

Int32

追加する秒の値です。

戻り値

DateTime

指定した DateTime に指定した秒数を加算した結果の DateTime。

例外

ArgumentException

結果として得られる DateTime がこのカレンダーでサポートされている範囲外です。

ArgumentOutOfRangeException

seconds は DateTime の戻り値でサポートされている範囲外です。

例

次のコード例は、 クラスのメンバーを Calendar 示しています。

C#

using System;
using System.Globalization;

public class SamplesCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Uses the default calendar of the InvariantCulture.
      Calendar myCal = CultureInfo.InvariantCulture.Calendar;

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears( myDT, 5 );
      myDT = myCal.AddMonths( myDT, 5 );
      myDT = myCal.AddWeeks( myDT, 5 );
      myDT = myCal.AddDays( myDT, 5 );
      myDT = myCal.AddHours( myDT, 5 );
      myDT = myCal.AddMinutes( myDT, 5 );
      myDT = myCal.AddSeconds( myDT, 5 );
      myDT = myCal.AddMilliseconds( myDT, 5 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding 5 to each component of the DateTime:" );
      DisplayValues( myCal, myDT );
   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:          {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:         {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:        {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:    {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth:   {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:    {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine( "   Hour:         {0}", myCal.GetHour( myDT ) );
      Console.WriteLine( "   Minute:       {0}", myCal.GetMinute( myDT ) );
      Console.WriteLine( "   Second:       {0}", myCal.GetSecond( myDT ) );
      Console.WriteLine( "   Milliseconds: {0}", myCal.GetMilliseconds( myDT ) );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:          1
   Year:         2002
   Month:        4
   DayOfYear:    93
   DayOfMonth:   3
   DayOfWeek:    Wednesday
   Hour:         0
   Minute:       0
   Second:       0
   Milliseconds: 0

After adding 5 to each component of the DateTime:
   Era:          1
   Year:         2007
   Month:        10
   DayOfYear:    286
   DayOfMonth:   13
   DayOfWeek:    Saturday
   Hour:         5
   Minute:       5
   Second:       5
   Milliseconds: 5

*/

注釈

値は seconds 、指定した に追加されます DateTime。 が負の場合 seconds 、結果 DateTime は指定した DateTimeよりも前になります。

結果の時刻が指定した DateTimeの日以外の場合、結果DateTimeの日の部分が影響を受ける。 結果の日が指定DateTimeした の月以外の場合、結果DateTimeの月の部分が影響を受ける。 結果の月が指定DateTimeした の年以外の場合、結果DateTimeの年部分が影響を受ける。 結果として得られる年が、指定した DateTimeの時代 (年号) 以外の場合、結果DateTimeの元号部分が影響を受ける。

返されるDateTime値の プロパティはKind常に とDateTimeKind.Unspecified等しくなります。 次の例に Kind 示すように、 メソッドを time 呼び出 DateTime.SpecifyKind すことで、 パラメーターの プロパティを保持できます。

C#

returnTime = DateTime.SpecifyKind(cal.AddSeconds(time, seconds), time.Kind);

適用対象

こちらもご覧ください

• DateTime
• AddYears(DateTime, Int32)
• AddMonths(DateTime, Int32)
• AddWeeks(DateTime, Int32)
• AddDays(DateTime, Int32)
• AddHours(DateTime, Int32)
• AddMinutes(DateTime, Int32)
• AddMilliseconds(DateTime, Double)