Calendar Classe

Définition

Représente des unités de division du temps, telles que les semaines, les mois et les années.Represents time in divisions, such as weeks, months, and years.

public ref class Calendar abstract
public ref class Calendar abstract : ICloneable
public abstract class Calendar
public abstract class Calendar : ICloneable
[System.Serializable]
public abstract class Calendar
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Calendar : ICloneable
type Calendar = class
type Calendar = class
    interface ICloneable
Public MustInherit Class Calendar
Public MustInherit Class Calendar
Implements ICloneable
Héritage
Calendar
Dérivé
Attributs
Implémente

Exemples

L’exemple de code suivant illustre les membres de la classe Calendar.The following code example demonstrates the members of the Calendar class.

using namespace System;
using namespace System::Globalization;
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();
}

int main()
{
   
   // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
   DateTime myDT = DateTime(2002,4,3,gcnew 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 );
}

/*
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

*/
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

Remarques

Un calendrier divise le temps en unités, telles que les semaines, les mois et les années.A calendar divides time into units, such as weeks, months, and years. Le nombre, la longueur et le début des divisions varient dans chaque calendrier.The number, length, and start of the divisions vary in each calendar.

Notes

Pour plus d’informations sur l’utilisation des classes Calendar dans .NET, consultez utilisation des calendriers.For information about using the calendar classes in .NET, see Working with Calendars.

Tout moment dans le temps peut être représenté sous la forme d’un ensemble de valeurs numériques à l’aide d’un calendrier particulier.Any moment in time can be represented as a set of numeric values using a particular calendar. Par exemple, un Vernal Equinox s’est produit à (1999, 3, 20, 8, 46, 0, 0,0) dans le calendrier grégorien, c’est-à-dire le 20 mars, 1999 (notre ère).For example, a vernal equinox occurred at (1999, 3, 20, 8, 46, 0, 0.0) in the Gregorian calendar, that is, March 20, 1999 C.E. à 8:46:00:0.0.at 8:46:00:0.0. Une implémentation de Calendar peut mapper n’importe quelle date de la plage d’un calendrier spécifique à un ensemble similaire de valeurs numériques, et DateTime pouvez mapper ces ensembles de valeurs numériques à une représentation textuelle à l’aide des informations de Calendar et DateTimeFormatInfo.An implementation of Calendar can map any date in the range of a specific calendar to a similar set of numeric values, and DateTime can map such sets of numeric values to a textual representation using information from Calendar and DateTimeFormatInfo. La représentation textuelle peut être dépendante de la culture, par exemple, « 8:46 AM du 20 mars 1999 AD » pour la culture en-US, ou non-respect de la culture, par exemple, « 1999-03-20T08:46:00 » au format ISO 8601.The textual representation can be culture-sensitive, for example, "8:46 AM March 20th 1999 AD" for the en-US culture, or culture-insensitive, for example, "1999-03-20T08:46:00" in ISO 8601 format.

Une implémentation de Calendar peut définir une ou plusieurs ères.A Calendar implementation can define one or more eras. La classe Calendar identifie les ères comme des entiers énumérés, où l’ère actuelle (CurrentEra) a la valeur 0.The Calendar class identifies the eras as enumerated integers, where the current era (CurrentEra) has the value 0.

Important

Les ères des calendriers japonais sont basées sur le règne de l’empereur et sont donc amenées à changer.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Par exemple, le 1 mai 2019 a marqué le début de l’ère Reiwa dans JapaneseCalendar et JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Ce changement d’ère affecte toutes les applications qui utilisent ces calendriers.Such a change of era affects all applications that use these calendars. Pour plus d’informations et pour déterminer si vos applications sont affectées, consultez Handling a new era in the Japanese calendar in .NET.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Pour plus d’informations sur le test de vos applications sur les systèmes Windows pour garantir leur préparation au changement d’ère, consultez Préparer votre application au changement de l’ère japonaise.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. Consultez Utilisation des ères pour connaître les fonctionnalités de .NET qui prennent en charge les calendriers avec plusieurs ères et les bonnes pratiques d’utilisation de ce type de calendrier.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

Pour créer la différence entre l’année civile et l’heure réelle à laquelle la terre pivote autour du soleil ou l’heure à laquelle la lune pivote autour de la terre, une année bissextile a un nombre de jours différent d’une année civile standard.To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Chaque implémentation de Calendar définit des années bissextiles différemment.Each Calendar implementation defines leap years differently.

Pour des fins de cohérence, la valeur 1 est affectée à la première unité de chaque intervalle (le premier mois, par exemple).For consistency, the first unit in each interval (the first month, for example) is assigned the value 1.

L’espace de noms System.Globalization comprend les implémentations de Calendar suivantes :The System.Globalization namespace includes the following Calendar implementations:

Constructeurs

Calendar()

Initialise une nouvelle instance de la classe Calendar.Initializes a new instance of the Calendar class.

Champs

CurrentEra

Représente l’ère actuelle du calendrier en cours.Represents the current era of the current calendar. La valeur de ce champ est 0.The value of this field is 0.

Propriétés

AlgorithmType

Obtient une valeur qui indique si le calendrier actuel est solaire, lunaire, ou une combinaison des deux.Gets a value indicating whether the current calendar is solar-based, lunar-based, or a combination of both.

DaysInYearBeforeMinSupportedYear

Obtient le nombre de jours dans l’année qui précède l’année spécifiée par la propriété MinSupportedDateTime.Gets the number of days in the year that precedes the year that is specified by the MinSupportedDateTime property.

Eras

En cas de substitution dans une classe dérivée, obtient la liste des ères du calendrier en cours.When overridden in a derived class, gets the list of eras in the current calendar.

IsReadOnly

Obtient une valeur qui indique si cet objet Calendar est en lecture seule.Gets a value indicating whether this Calendar object is read-only.

MaxSupportedDateTime

Obtient les dernières date et heure prises en charge par cet objet Calendar.Gets the latest date and time supported by this Calendar object.

MinSupportedDateTime

Obtient les premières date et heure prises en charge par cet objet Calendar.Gets the earliest date and time supported by this Calendar object.

TwoDigitYearMax

Obtient ou définit la dernière année d'une plage de 100 ans pouvant être représentée par une année à 2 chiffres.Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.

Méthodes

AddDays(DateTime, Int32)

Retourne un DateTime qui est le nombre de jours spécifié jusqu’au DateTime spécifié.Returns a DateTime that is the specified number of days away from the specified DateTime.

AddHours(DateTime, Int32)

Retourne un DateTime qui représente le nombre d’heures jusqu’au DateTime spécifié.Returns a DateTime that is the specified number of hours away from the specified DateTime.

AddMilliseconds(DateTime, Double)

Retourne un DateTime qui correspond au nombre de millisecondes spécifié jusqu’au DateTime spécifié.Returns a DateTime that is the specified number of milliseconds away from the specified DateTime.

AddMinutes(DateTime, Int32)

Retourne un DateTime qui correspond au nombre de minutes jusqu’au DateTime spécifié.Returns a DateTime that is the specified number of minutes away from the specified DateTime.

AddMonths(DateTime, Int32)

En cas de substitution dans une classe dérivée, retourne un DateTime qui correspond au nombre de mois spécifié jusqu’au DateTime spécifié.When overridden in a derived class, returns a DateTime that is the specified number of months away from the specified DateTime.

AddSeconds(DateTime, Int32)

Retourne un DateTime qui correspond au nombre de secondes spécifié jusqu’au DateTime spécifié.Returns a DateTime that is the specified number of seconds away from the specified DateTime.

AddWeeks(DateTime, Int32)

Retourne un DateTime qui correspond au nombre de semaines spécifié jusqu’au DateTime spécifié.Returns a DateTime that is the specified number of weeks away from the specified DateTime.

AddYears(DateTime, Int32)

En cas de substitution dans une classe dérivée, retourne un DateTime qui correspond au nombre d’années spécifié jusqu’au DateTime spécifié.When overridden in a derived class, returns a DateTime that is the specified number of years away from the specified DateTime.

Clone()

Crée un objet qui est une copie de l’objet Calendar actuel.Creates a new object that is a copy of the current Calendar object.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetDayOfMonth(DateTime)

En cas de substitution dans une classe dérivée, retourne le jour du mois du DateTime spécifié.When overridden in a derived class, returns the day of the month in the specified DateTime.

GetDayOfWeek(DateTime)

En cas de substitution dans une classe dérivée, retourne le jour de la semaine du DateTime spécifié.When overridden in a derived class, returns the day of the week in the specified DateTime.

GetDayOfYear(DateTime)

En cas de substitution dans une classe dérivée, retourne le jour de l’année du DateTime spécifié.When overridden in a derived class, returns the day of the year in the specified DateTime.

GetDaysInMonth(Int32, Int32)

Retourne le nombre de jours dans le mois et l’année spécifiés de l’ère actuelle.Returns the number of days in the specified month and year of the current era.

GetDaysInMonth(Int32, Int32, Int32)

En cas de substitution dans une classe dérivée, retourne le nombre de jours du mois, de l’année et de l’ère spécifiés.When overridden in a derived class, returns the number of days in the specified month, year, and era.

GetDaysInYear(Int32)

Retourne le nombre de jours de l’année spécifiée de l’ère actuelle.Returns the number of days in the specified year of the current era.

GetDaysInYear(Int32, Int32)

En cas de substitution dans une classe dérivée, retourne le nombre de jours de l’année et de l’ère spécifiées.When overridden in a derived class, returns the number of days in the specified year and era.

GetEra(DateTime)

En cas de substitution dans une classe dérivée, retourne l’ère du DateTime spécifié.When overridden in a derived class, returns the era of the specified DateTime.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetHour(DateTime)

Retourne l’heure du DateTime spécifié.Returns the hours value in the specified DateTime.

GetLeapMonth(Int32)

Calcule le mois d’une année bissextile d’une spécifiée.Calculates the leap month for a specified year.

GetLeapMonth(Int32, Int32)

Calcule le mois d’une année bissextile d’une année et d’une ère spécifiées.Calculates the leap month for a specified year and era.

GetMilliseconds(DateTime)

Retourne la valeur en millisecondes du DateTime spécifié.Returns the milliseconds value in the specified DateTime.

GetMinute(DateTime)

Retourne les minutes du DateTime spécifié.Returns the minutes value in the specified DateTime.

GetMonth(DateTime)

En cas de substitution dans une classe dérivée, retourne le mois du DateTime spécifié.When overridden in a derived class, returns the month in the specified DateTime.

GetMonthsInYear(Int32)

Retourne le nombre de mois de l’année spécifiée dans l’ère actuelle.Returns the number of months in the specified year in the current era.

GetMonthsInYear(Int32, Int32)

En cas de substitution dans une classe dérivée, retourne le nombre de mois de l’année spécifiée dans l’ère spécifiée.When overridden in a derived class, returns the number of months in the specified year in the specified era.

GetSecond(DateTime)

Retourne les secondes du DateTime spécifié.Returns the seconds value in the specified DateTime.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Retourne la semaine de l’année qui contient la date de la valeur DateTime spécifiée.Returns the week of the year that includes the date in the specified DateTime value.

GetYear(DateTime)

En cas de substitution dans une classe dérivée, retourne l’année du DateTime spécifié.When overridden in a derived class, returns the year in the specified DateTime.

IsLeapDay(Int32, Int32, Int32)

Détermine si la date spécifiée dans l’ère en cours est une année bissextile.Determines whether the specified date in the current era is a leap day.

IsLeapDay(Int32, Int32, Int32, Int32)

En cas de substitution dans une classe dérivée, détermine si la date spécifiée dans l’ère spécifiée est un jour bissextile.When overridden in a derived class, determines whether the specified date in the specified era is a leap day.

IsLeapMonth(Int32, Int32)

Détermine si le mois spécifié de l’année spécifiée dans l’ère en cours est un mois bissextile.Determines whether the specified month in the specified year in the current era is a leap month.

IsLeapMonth(Int32, Int32, Int32)

En cas de substitution dans une classe dérivée, détermine si le mois de l’année spécifiée dans l’ère spécifiée est un mois bissextile.When overridden in a derived class, determines whether the specified month in the specified year in the specified era is a leap month.

IsLeapYear(Int32)

Détermine si l’année spécifiée dans l’ère actuelle est une année bissextile.Determines whether the specified year in the current era is a leap year.

IsLeapYear(Int32, Int32)

En cas de substitution dans une classe dérivée, détermine si l’année spécifiée dans l’ère spécifiée est une année bissextile.When overridden in a derived class, determines whether the specified year in the specified era is a leap year.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ReadOnly(Calendar)

Retourne une version en lecture seule de l’objet Calendar spécifié.Returns a read-only version of the specified Calendar object.

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Retourne un DateTime correspondant à la date et à l’heure spécifiées pour l’ère actuelle.Returns a DateTime that is set to the specified date and time in the current era.

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

En cas de substitution dans une classe dérivée, retourne un DateTime correspondant à la date et à l’heure spécifiées pour l’ère spécifiée.When overridden in a derived class, returns a DateTime that is set to the specified date and time in the specified era.

ToFourDigitYear(Int32)

Convertit l’année spécifiée en une année à quatre chiffres en utilisant la propriété TwoDigitYearMax pour déterminer le siècle approprié.Converts the specified year to a four-digit year by using the TwoDigitYearMax property to determine the appropriate century.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi