Calendar.AddWeeks(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 settimane specificato a partire dal valore DateTime specificato.

C#

public virtual DateTime AddWeeks (DateTime time, int weeks);

Parametri

time

DateTime

Valore DateTime al quale aggiungere le settimane.

weeks

Int32

numero di settimane da aggiungere.

Restituisce

DateTime

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

Eccezioni

ArgumentException

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

ArgumentOutOfRangeException

weeks 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 weeks valore viene aggiunto all'oggetto specificato DateTime. Se weeks è negativo, l'oggetto risultante DateTime è precedente all'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 parte relativa all'ora del giorno risultante DateTime rimane la stessa dell'oggetto specificato DateTime.

In tutte le classi .NET derivate dalla Calendar classe , una settimana viene definita come sette giorni.

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.AddWeeks(time, weeks), time.Kind);

Si applica a

Vedi anche

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