Calendar.AddMinutes(DateTime, Int32) Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Origine:

Calendar.cs

Restituisce un valore DateTime che rappresenta il numero di minuti specificato a partire dal valore DateTime specificato.

C#

public virtual DateTime AddMinutes (DateTime time, int minutes);

Parametri

time

DateTime

Valore DateTime al quale aggiungere i minuti.

minutes

Int32

Numero di minuti da aggiungere.

Restituisce

DateTime

Valore DateTime risultante dalla somma del numero specificato di minuti e del valore DateTime specificato.

Eccezioni

ArgumentException

L'oggetto DateTime risultante non è compreso nell'intervallo supportato dal calendario.

ArgumentOutOfRangeException

minutes non è compreso nell'intervallo supportato dal valore DateTime restituito.

Esempio

Nell'esempio di codice seguente vengono illustrati i membri della Calendar classe .

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

*/

Commenti

Il minutes valore viene aggiunto all'oggetto specificato DateTime. Se minutes è negativo, l'oggetto risultante DateTime è precedente all'oggetto specificato DateTime.

La parte del giorno dell'oggetto risultante è interessata se l'ora risultante DateTime è esterna al giorno dell'oggetto specificato DateTime. La parte mensile dell'oggetto risultante DateTime è interessata se il giorno risultante non rientra nel mese dell'oggetto specificato DateTime. La parte dell'anno risultante DateTime è interessata se il mese risultante non rientra nell'anno dell'oggetto specificato DateTime. La parte dell'era dell'oggetto risultante DateTime è influenzata se l'anno risultante non rientra nell'era dell'oggetto specificato DateTime.

La Kind proprietà del valore restituito DateTime è sempre uguale a DateTimeKind.Unspecified. È possibile mantenere la Kind proprietà del time parametro chiamando il DateTime.SpecifyKind metodo , come illustrato nell'esempio seguente.

C#

returnTime = DateTime.SpecifyKind(cal.AddMinutes(time, minutes), time.Kind);

Si applica a

Vedi anche

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