CalendarWeekRule Énumération

Définition

public enum class CalendarWeekRule

public enum CalendarWeekRule

[System.Serializable]
public enum CalendarWeekRule

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum CalendarWeekRule

type CalendarWeekRule = 

[<System.Serializable>]
type CalendarWeekRule = 

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CalendarWeekRule = 

Public Enum CalendarWeekRule

Héritage

Object

ValueType

Enum

CalendarWeekRule

Attributs

SerializableAttribute ComVisibleAttribute

Champs

Remarques

Un membre de l’énumération CalendarWeekRule est retourné par la DateTimeFormatInfo.CalendarWeekRule propriété et est utilisé par le calendrier actuel de la culture pour déterminer la règle de semaine civile. La valeur d’énumération est également utilisée comme paramètre de la Calendar.GetWeekOfYear méthode .

Les règles de semaine civile dépendent de la System.DayOfWeek valeur qui indique le premier jour de la semaine en plus de dépendre d’une CalendarWeekRule valeur. La DateTimeFormatInfo.FirstDayOfWeek propriété fournit la valeur par défaut d’une culture, mais n’importe quelle DayOfWeek valeur peut être spécifiée comme premier jour de la semaine dans la Calendar.GetWeekOfYear méthode.

La première semaine basée sur la FirstDay valeur peut avoir un à sept jours. La première semaine basée sur la FirstFullWeek valeur a toujours sept jours. La première semaine basée sur la FirstFourDayWeek valeur peut avoir quatre à sept jours.

Par exemple, dans le calendrier grégorien, supposons que le premier jour de l’année (le 1er janvier) tombe un mardi et que le premier jour désigné de la semaine est le dimanche. FirstFullWeek La sélection définit le premier dimanche (6 janvier) comme début de la première semaine de l’année. Les cinq premiers jours de l’année sont considérés comme faisant partie de la dernière semaine de l’année précédente. En revanche, la sélection FirstFourDayWeek définit le premier jour de l’année (1er janvier) comme le début de la première semaine de l’année, car il y a plus de quatre jours entre le 1er janvier et le jour précédant le dimanche suivant.

Supposons que le premier jour de l’année (le 1er janvier) tombe un vendredi et que le premier jour désigné de la semaine est le dimanche. La sélection FirstFourDayWeek définit le premier dimanche (3 janvier) comme début de la première semaine de l’année, car il y a moins de quatre jours entre le 1er janvier et le jour précédant le dimanche suivant.

L’exemple suivant montre comment les CalendarWeekRule valeurs et DayOfWeek sont utilisées ensemble pour déterminer la façon dont les semaines sont attribuées. Dans le calendrier grégorien, le premier jour de l’année (1er janvier) en 2013 tombe un mardi. Si le premier jour de la semaine désigné est le dimanche, le premier dimanche (6 janvier) est le premier jour de la première semaine de l’année et le samedi (5 janvier) appartient à la cinquante-troisième semaine de l’année précédente. La modification de la règle FirstFourDayWeek de la semaine civile en définit le mardi (1er janvier) comme début de la première semaine de l’année, car il y a plus de quatre jours entre le mardi 1er janvier et le dimanche 6 janvier. En utilisant cette règle, le 5 janvier appartient à la première semaine de l’année. Pour 2010, année au cours de laquelle le 1er janvier tombe un vendredi, l’application de la FirstFourDayWeek règle avec DayOfWeek.Sunday comme premier jour de la semaine fait du dimanche 3 janvier le début de la première semaine de l’année, car la première semaine de 2010 qui a plus de quatre jours est du 3 au 9 janvier.

using System;
using System.Globalization;

public class Example
{
   static Calendar cal = new GregorianCalendar();

   public static void Main()
   {
      DateTime date = new DateTime(2013, 1, 5);
      DayOfWeek firstDay = DayOfWeek.Sunday;
      CalendarWeekRule rule;

      rule = CalendarWeekRule.FirstFullWeek;
      ShowWeekNumber(date, rule, firstDay);

      rule = CalendarWeekRule.FirstFourDayWeek;
      ShowWeekNumber(date, rule, firstDay);

      Console.WriteLine();
      date = new DateTime(2010, 1, 3);
      ShowWeekNumber(date, rule, firstDay);
   }

   private static void ShowWeekNumber(DateTime dat, CalendarWeekRule rule,
                                      DayOfWeek firstDay)
   {
      Console.WriteLine("{0:d} with {1:F} rule and {2:F} as first day of week: week {3}",
                        dat, rule, firstDay, cal.GetWeekOfYear(dat, rule, firstDay));
   }
}
// The example displays the following output:
//       1/5/2013 with FirstFullWeek rule and Sunday as first day of week: week 53
//       1/5/2013 with FirstFourDayWeek rule and Sunday as first day of week: week 1
//
//       1/3/2010 with FirstFourDayWeek rule and Sunday as first day of week: week 1

Imports System.Globalization

Module Example
   
   Dim cal As New GregorianCalendar()
   
   Public Sub Main()
      Dim dat As Date = #01/05/2013#
      Dim firstDay As DayOfWeek = DayOfWeek.Sunday
      Dim rule As CalendarWeekRule
      
      rule = CalendarWeekRule.FirstFullWeek
      ShowWeekNumber(dat, rule, firstDay)
      
      rule = CalendarWeekRule.FirstFourDayWeek
      ShowWeekNumber(dat, rule, firstDay)

      Console.WriteLine()
      dat = #1/03/2010#
      ShowWeekNumber(dat, rule, firstDay)
   End Sub
   
   Private Sub ShowWeekNumber(dat As Date, rule As CalendarWeekRule, 
                              firstDay As DayOfWeek)
      Console.WriteLine("{0:d} with {1:F} rule and {2:F} as first day of week: week {3}",
                        dat, rule, firstDay, cal.GetWeekOfYear(dat, rule, firstDay))
   End Sub   
End Module
' The example displays the following output:
'       1/5/2013 with FirstFullWeek rule and Sunday as first day of week: week 53
'       1/5/2013 with FirstFourDayWeek rule and Sunday as first day of week: week 1
'       
'       1/3/2010 with FirstFourDayWeek rule and Sunday as first day of week: week 1

Chaque CultureInfo objet prend en charge un ensemble de calendriers. La Calendar propriété retourne le calendrier par défaut de la culture, et la OptionalCalendars propriété renvoie un tableau contenant tous les calendriers pris en charge par la culture. Pour modifier le calendrier utilisé par un CultureInfo, définissez la Calendar propriété de CultureInfo.DateTimeFormat sur un nouveau Calendar.

S’applique à

Voir aussi

• Calendar
• OptionalCalendars