CalendarWeekRule Výčet

Definice

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

Dědičnost

Object

ValueType

Enum

CalendarWeekRule

Atributy

SerializableAttribute ComVisibleAttribute

Pole

Poznámky

Člen výčtu CalendarWeekRule je vrácen DateTimeFormatInfo.CalendarWeekRule vlastností a je používán aktuálním kalendářem jazykové verze k určení pravidla kalendářního týdne. Hodnota výčtu se také používá jako parametr Calendar.GetWeekOfYear metody.

Pravidla kalendářního týdne závisí na hodnotě System.DayOfWeek , která kromě hodnoty označuje první den v týdnu CalendarWeekRule . Vlastnost DateTimeFormatInfo.FirstDayOfWeek poskytuje výchozí hodnotu pro jazykovou verzi, ale libovolnou DayOfWeek hodnotu lze v metodě zadat jako první den v týdnu Calendar.GetWeekOfYear .

První týden založený na hodnotě FirstDay může mít jeden až sedm dnů. První týden založený na hodnotě FirstFullWeek má vždy sedm dní. První týden založený na hodnotě FirstFourDayWeek může mít čtyři až sedm dní.

Například v gregoriánském kalendáři předpokládejme, že první den v roce (1. leden) připadá na úterý a určený první den v týdnu je neděle. Výběrem FirstFullWeek definujete první neděli (6. ledna) jako začátek prvního týdne v roce. Prvních pět dnů v roce se považuje za součást posledního týdne předchozího roku. Výběr naopak FirstFourDayWeek definuje první den v roce (1. ledna) jako začátek prvního týdne roku, protože od 1. ledna do dne předcházejícího následující neděli jsou více než čtyři dny.

Předpokládejme, že první den v roce (1. leden) spadá na pátek a určený první den v týdnu je neděle. Výběrem FirstFourDayWeek definujete první neděli (3. ledna) jako začátek prvního týdne v roce, protože od 1. ledna do dne předcházejícího následující neděli jsou méně než čtyři dny.

Následující příklad ukazuje, jak CalendarWeekRule se hodnoty a DayOfWeek používají společně k určení způsobu přiřazení týdnů. V gregoriánském kalendáři spadá první den roku (1. ledna) v roce 2013 na úterý. Pokud je prvním dnem týdne neděle, je první neděle (6. ledna) prvním dnem prvního týdne v roce a sobota (5. ledna) patří padesátému třetímu týdnu předchozího roku. Změna pravidla kalendářního týdne na FirstFourDayWeek definuje úterý (1. ledna) jako začátek prvního týdne roku, protože mezi úterým 1. lednem a neděli 6. ledna jsou více než čtyři dny. Pokud použijete toto pravidlo, 5. leden patří prvnímu týdnu v roce. V roce 2010, ve kterém 1. leden spadá do pátku, FirstFourDayWeek platí pravidlo s DayOfWeek.Sunday prvním dnem týdne tak, že neděle, leden 3 začátek prvního týdne roku, protože první týden v roce 2010, který má více než čtyři dny, je 3. až 9. ledna.

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

Každý CultureInfo objekt podporuje sadu kalendářů. Vlastnost Calendar vrátí výchozí kalendář pro jazykovou verzi a OptionalCalendars vlastnost vrátí pole obsahující všechny kalendáře podporované jazykovou verzí. Pokud chcete změnit kalendář používaný objektem CultureInfo, nastavte Calendar vlastnost CultureInfo.DateTimeFormat na nový Calendar.

Platí pro

Viz také

• Calendar
• OptionalCalendars