CalendarWeekRule Enum

Definitie

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

Overname

Object

ValueType

Enum

CalendarWeekRule

Kenmerken

SerializableAttribute ComVisibleAttribute

Velden

Opmerkingen

Een lid van de CalendarWeekRule opsomming wordt geretourneerd door de DateTimeFormatInfo.CalendarWeekRule eigenschap en wordt gebruikt door de huidige agenda van de cultuur om de kalenderweekregel te bepalen. De opsommingswaarde wordt ook gebruikt als parameter voor de Calendar.GetWeekOfYear methode.

Kalenderweekregels zijn afhankelijk van de System.DayOfWeek waarde die de eerste dag van de week aangeeft, naast afhankelijk van een CalendarWeekRule waarde. De DateTimeFormatInfo.FirstDayOfWeek eigenschap biedt de standaardwaarde voor een cultuur, maar elke DayOfWeek waarde kan worden opgegeven als de eerste dag van de week in de Calendar.GetWeekOfYear methode.

De eerste week op basis van de FirstDay waarde kan één tot zeven dagen duren. De eerste week op basis van de FirstFullWeek waarde heeft altijd zeven dagen. De eerste week op basis van de FirstFourDayWeek waarde kan vier tot zeven dagen duren.

Stel dat in de Gregoriaanse kalender de eerste dag van het jaar (1 januari) op een dinsdag valt en de aangewezen eerste dag van de week zondag is. Als u FirstFullWeek selecteert, wordt de eerste zondag (6 januari) gedefinieerd als het begin van de eerste week van het jaar. De eerste vijf dagen van het jaar worden beschouwd als onderdeel van de vorige week van het vorige jaar. Als u daarentegen selecteert FirstFourDayWeek , wordt de eerste dag van het jaar (1 januari) gedefinieerd als het begin van de eerste week van het jaar, omdat er meer dan vier dagen zijn van 1 januari tot de dag vóór de volgende zondag.

Stel dat de eerste dag van het jaar (1 januari) op een vrijdag valt en dat de eerste dag van de week zondag is. Als u FirstFourDayWeek selecteert, wordt de eerste zondag (3 januari) gedefinieerd als het begin van de eerste week van het jaar, omdat er minder dan vier dagen zijn van 1 januari tot de dag vóór de volgende zondag.

In het volgende voorbeeld ziet u hoe de CalendarWeekRule en DayOfWeek waarden samen worden gebruikt om te bepalen hoe weken worden toegewezen. In de Gregoriaanse kalender valt de eerste dag van het jaar (1 januari) in 2013 op een dinsdag. Als de eerste dag van de week zondag is, is de eerste zondag (6 januari) de eerste dag van de eerste week van het jaar en de zaterdag (5 januari) behoort tot de vijftig derde week van het vorige jaar. Als u de kalenderweekregel wijzigt om dinsdag (1 januari) te FirstFourDayWeek definiëren als het begin van de eerste week van het jaar, omdat er meer dan vier dagen tussen dinsdag 1 januari en zondag 6 zijn. Met deze regel behoort 5 januari tot de eerste week van het jaar. Voor 2010, een jaar waarin 1 januari valt op een vrijdag, waarbij de FirstFourDayWeek regel wordt DayOfWeek.Sunday toegepast als de eerste dag van de week zondag, 3 januari het begin van de eerste week van het jaar, omdat de eerste week in 2010 die meer dan vier dagen heeft, 3 tot en met 9 is.

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

Elk CultureInfo object ondersteunt een set agenda's. De Calendar eigenschap retourneert de standaardkalender voor de cultuur en de OptionalCalendars eigenschap retourneert een matrix met alle agenda's die door de cultuur worden ondersteund. Als u de agenda wilt wijzigen die wordt gebruikt door een CultureInfo, stelt u de Calendar eigenschap van CultureInfo.DateTimeFormat in op een nieuwe Calendar.

Zie ook

• Calendar
• OptionalCalendars