Calendar Classe

Definizione

Spazio dei nomi:
System.Globalization
Assembly:
mscorlib.dll, System.Globalization.dll
Assembly:
mscorlib.dll
Assembly:
System.Globalization.dll
Assembly:
netstandard.dll

Rappresenta il tempo nelle divisioni, ad esempio settimane, mesi e anni.

public ref class Calendar abstract
public ref class Calendar abstract : ICloneable
public abstract class Calendar
[System.Serializable]
public abstract class Calendar
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Calendar : ICloneable
public abstract class Calendar : ICloneable
type Calendar = class
[<System.Serializable>]
type Calendar = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Calendar = class
    interface ICloneable
type Calendar = class
    interface ICloneable
Public MustInherit Class Calendar
Public MustInherit Class Calendar
Implements ICloneable
Ereditarietà
Object
Calendar
Derivato
Attributi
SerializableAttribute ComVisibleAttribute
Implementazioni
ICloneable

Esempio

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

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

*/

Imports System.Globalization


Public Class SamplesCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())

      ' Uses the default calendar of the InvariantCulture.
      Dim myCal As Calendar = 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)

   End Sub

   Public Shared Sub DisplayValues(myCal As Calendar, myDT As DateTime)
      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()
   End Sub

End Class


'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

Un calendario divide il tempo in unità, ad esempio settimane, mesi e anni. Il numero, la lunghezza e l'inizio delle divisioni variano in ogni calendario.

Note

Per informazioni sull'uso delle classi di calendario in .NET, vedere Working with Calendars.

Qualsiasi momento nel tempo può essere rappresentato come un set di valori numerici usando un determinato calendario. Ad esempio, un equinozio vernal si è verificato in (1999, 3, 20, 8, 46, 0, 0,0) nel calendario gregoriano, ovvero il 20 marzo 1999 C.E. alle 8:46:00:0.0. Un'implementazione di Calendar può eseguire il mapping di qualsiasi data nell'intervallo di un calendario specifico a un set simile di valori numerici e DateTime può eseguire il mapping di tali set di valori numerici a una rappresentazione testuale usando informazioni da Calendar e DateTimeFormatInfo. La rappresentazione testuale può essere sensibile alle impostazioni cultura, ad esempio "8:46 MARZO 20th 1999 AD" per le impostazioni cultura en-US o culture-insensitive, ad esempio "1999-03-20T08:46:00" in formato ISO 8601.

Un'implementazione Calendar può definire una o più ere. La Calendar classe identifica le ere come numeri interi enumerati, dove l'era corrente (CurrentEra) ha il valore 0.

Importante

Le ere nei calendari giapponesi si basano sul regno dell'imperatore e quindi si prevede di cambiare. Ad esempio, il 1° maggio 2019 ha contrassegnato l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar. Tale cambiamento di era influisce su tutte le applicazioni che usano questi calendari. Per altre informazioni e per determinare se le applicazioni sono interessate, vedere Gestione di una nuova era nel calendario giapponese in .NET. Per informazioni sui test delle applicazioni nei sistemi Windows per garantire la conformità per il cambiamento dell'era, vedere Preparare l'applicazione per il cambiamento dell'era giapponese. Per le funzionalità di .NET che supportano calendari con più ere e per le procedure consigliate quando si usano calendari che supportano più ere, vedere Uso delle era.

Per fare la differenza tra l'anno di calendario e l'ora effettiva che la terra ruota intorno al sole o l'ora effettiva che la luna ruota intorno alla terra, un anno bisestile ha un numero diverso di giorni rispetto a un anno di calendario standard. Ogni Calendar implementazione definisce anni bisestili in modo diverso.

Per coerenza, alla prima unità in ogni intervallo (ad esempio il primo mese) viene assegnato il valore 1.

Lo System.Globalization spazio dei nomi include le implementazioni seguenti Calendar :

Costruttori

Nome Descrizione
Calendar()

Inizializza una nuova istanza della classe Calendar.

Campi

Nome Descrizione
CurrentEra

Rappresenta l'era corrente del calendario corrente. Il valore di questo campo è 0.

Proprietà

Nome Descrizione
AlgorithmType

Ottiene un valore che indica se il calendario corrente è basato su solare, lunare o una combinazione di entrambi.
DaysInYearBeforeMinSupportedYear

Ottiene il numero di giorni nell'anno che precede l'anno specificato dalla MinSupportedDateTime proprietà .
Eras

In caso di override in una classe derivata, ottiene l'elenco di ere nel calendario corrente.
IsReadOnly

Ottiene un valore che indica se l'oggetto Calendar è di sola lettura.
MaxSupportedDateTime

Ottiene la data e l'ora più recenti supportate da questo Calendar oggetto.
MinSupportedDateTime

Ottiene la data e l'ora meno aggiornate supportate da questo Calendar oggetto.
TwoDigitYearMax

Ottiene o imposta l'ultimo anno di un intervallo di 100 anni che può essere rappresentato da un anno a 2 cifre.

Metodi

Nome Descrizione
AddDays(DateTime, Int32)

Restituisce un oggetto DateTime che rappresenta il numero specificato di giorni di distanza dall'oggetto specificato DateTime.
AddHours(DateTime, Int32)

Restituisce un oggetto DateTime che rappresenta il numero specificato di ore di distanza dall'oggetto specificato DateTime.
AddMilliseconds(DateTime, Double)

Restituisce un oggetto DateTime che rappresenta il numero specificato di millisecondi di distanza dall'oggetto specificato DateTime.
AddMinutes(DateTime, Int32)

Restituisce un oggetto DateTime che rappresenta il numero specificato di minuti di distanza dall'oggetto specificato DateTime.
AddMonths(DateTime, Int32)

Quando sottoposto a override in una classe derivata, restituisce un oggetto DateTime che rappresenta il numero di mesi specificato rispetto all'oggetto specificato DateTime.
AddSeconds(DateTime, Int32)

Restituisce un oggetto DateTime che rappresenta il numero specificato di secondi di distanza dall'oggetto specificato DateTime.
AddWeeks(DateTime, Int32)

Restituisce un oggetto DateTime che rappresenta il numero specificato di settimane di distanza dall'oggetto specificato DateTime.
AddYears(DateTime, Int32)

Quando sottoposto a override in una classe derivata, restituisce un oggetto DateTime che rappresenta il numero specificato di anni di distanza dall'oggetto specificato DateTime.
Clone()

Crea un nuovo oggetto che rappresenta una copia dell'oggetto corrente Calendar .
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetDayOfMonth(DateTime)

Quando sottoposto a override in una classe derivata, restituisce il giorno del mese nell'oggetto specificato DateTime.
GetDayOfWeek(DateTime)

Quando sottoposto a override in una classe derivata, restituisce il giorno della settimana nell'oggetto specificato DateTime.
GetDayOfYear(DateTime)

Quando sottoposto a override in una classe derivata, restituisce il giorno dell'anno nell'oggetto specificato DateTime.
GetDaysInMonth(Int32, Int32, Int32)

Quando sottoposto a override in una classe derivata, restituisce il numero di giorni nel mese, nell'anno e nell'era specificati.
GetDaysInMonth(Int32, Int32)

Restituisce il numero di giorni nel mese e nell'anno specificati dell'era corrente.
GetDaysInYear(Int32, Int32)

Quando sottoposto a override in una classe derivata, restituisce il numero di giorni nell'anno e nell'era specificati.
GetDaysInYear(Int32)

Restituisce il numero di giorni nell'anno specificato dell'era corrente.
GetEra(DateTime)

Quando sottoposto a override in una classe derivata, restituisce l'era dell'oggetto specificato DateTime.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetHour(DateTime)

Restituisce il valore delle ore nell'oggetto specificato DateTime.
GetLeapMonth(Int32, Int32)

Calcola il mese bisestile per un anno e un'era specificati.
GetLeapMonth(Int32)

Calcola il mese bisestile per un anno specificato.
GetMilliseconds(DateTime)

Restituisce il valore in millisecondi nell'oggetto specificato DateTime.
GetMinute(DateTime)

Restituisce il valore dei minuti nell'oggetto specificato DateTime.
GetMonth(DateTime)

Quando sottoposto a override in una classe derivata, restituisce il mese nell'oggetto specificato DateTime.
GetMonthsInYear(Int32, Int32)

Quando sottoposto a override in una classe derivata, restituisce il numero di mesi nell'anno specificato nell'era specificata.
GetMonthsInYear(Int32)

Restituisce il numero di mesi nell'anno specificato nell'era corrente.
GetSecond(DateTime)

Restituisce il valore dei secondi nell'oggetto specificato DateTime.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Restituisce la settimana dell'anno che include la data nel valore specificato DateTime .
GetYear(DateTime)

Quando sottoposto a override in una classe derivata, restituisce l'anno nell'oggetto specificato DateTime.
IsLeapDay(Int32, Int32, Int32, Int32)

Quando sottoposto a override in una classe derivata, determina se la data specificata nell'era specificata è un giorno bisestile.
IsLeapDay(Int32, Int32, Int32)

Determina se la data specificata nell'era corrente è un giorno bisestile.
IsLeapMonth(Int32, Int32, Int32)

Quando sottoposto a override in una classe derivata, determina se il mese specificato nell'anno specificato nell'era specificata è un mese bisestile.
IsLeapMonth(Int32, Int32)

Determina se il mese specificato nell'anno specificato nell'era corrente è un mese bisestile.
IsLeapYear(Int32, Int32)

Quando sottoposto a override in una classe derivata, determina se l'anno specificato nell'era specificata è un anno bisestile.
IsLeapYear(Int32)

Determina se l'anno specificato nell'era corrente è un anno bisestile.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ReadOnly(Calendar)

Restituisce una versione di sola lettura dell'oggetto specificato Calendar .
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Quando sottoposto a override in una classe derivata, restituisce un DateTime oggetto impostato sulla data e l'ora specificate nell'era specificata.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Restituisce un DateTime oggetto impostato sulla data e l'ora specificate nell'era corrente.
ToFourDigitYear(Int32)

Converte l'anno specificato in un anno a quattro cifre utilizzando la TwoDigitYearMax proprietà per determinare il secolo appropriato.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche