CalendarWeekRule Enum

Definition

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

Arv

Object

ValueType

Enum

CalendarWeekRule

Attribut

SerializableAttribute ComVisibleAttribute

Fält

Kommentarer

En medlem i CalendarWeekRule uppräkningen returneras av DateTimeFormatInfo.CalendarWeekRule egenskapen och används av kulturens aktuella kalender för att fastställa regeln för kalendervecka. Uppräkningsvärdet används också som en parameter till Calendar.GetWeekOfYear metoden.

Regler för kalendervecka beror på det System.DayOfWeek värde som anger den första dagen i veckan utöver beroende på ett CalendarWeekRule värde. Egenskapen DateTimeFormatInfo.FirstDayOfWeek tillhandahåller standardvärdet för en kultur, men valfritt DayOfWeek värde kan anges som den första dagen i veckan i Calendar.GetWeekOfYear metoden.

Den första veckan baserat på FirstDay värdet kan ha en till sju dagar. Den första veckan baserat på värdet FirstFullWeek har alltid sju dagar. Den första veckan baserat på FirstFourDayWeek värdet kan ha fyra till sju dagar.

Anta till exempel i den gregorianska kalendern att den första dagen på året (1 januari) infaller på en tisdag och den avsedda första dagen i veckan är söndag. När du väljer FirstFullWeek definieras den första söndagen (6 januari) som början av årets första vecka. Årets första fem dagar anses vara en del av föregående års sista vecka. Däremot definierar valet FirstFourDayWeek den första dagen på året (1 januari) som början av den första veckan på året eftersom det finns mer än fyra dagar från 1 januari till dagen före följande söndag.

Anta att den första dagen på året (1 januari) infaller på en fredag och den avsedda första dagen i veckan är söndag. När du väljer FirstFourDayWeek definieras den första söndagen (3 januari) som början av årets första vecka eftersom det är mindre än fyra dagar från 1 januari till dagen före följande söndag.

I följande exempel visas hur CalendarWeekRule värdena och DayOfWeek används tillsammans för att avgöra hur veckor tilldelas. I den gregorianska kalendern infaller den första dagen på året (1 januari) 2013 på en tisdag. Om den avsedda första dagen i veckan är söndag är den första söndagen (6 januari) den första dagen i årets första vecka och lördagen (5 januari) tillhör den femtiotredde veckan föregående år. Om du ändrar regeln för kalendervecka till FirstFourDayWeek definieras tisdag (1 januari) som början av årets första vecka, eftersom det är mer än fyra dagar mellan tisdag, 1 januari och söndag 6 januari. Med den här regeln tillhör den 5 januari årets första vecka. För 2010, ett år då 1 januari infaller på en fredag, tillämpar FirstFourDayWeek regeln med DayOfWeek.Sunday som den första dagen i veckan gör söndagen den 3 januari början av årets första vecka, eftersom den första veckan 2010 som har mer än fyra dagar är 3 januari till 9 januari.

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

Varje CultureInfo objekt stöder en uppsättning kalendrar. Egenskapen Calendar returnerar standardkalendern för kulturen och OptionalCalendars egenskapen returnerar en matris som innehåller alla kalendrar som stöds av kulturen. Om du vill ändra kalendern som används av en CultureInfoanger du Calendar egenskapen CultureInfo.DateTimeFormat för till en ny Calendar.

Se även

• Calendar
• OptionalCalendars