CalendarWeekRule Enumeração

Definição

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

Herança

Object

ValueType

Enum

CalendarWeekRule

Atributos

SerializableAttribute ComVisibleAttribute

Campos

Comentários

Um membro da CalendarWeekRule enumeração é retornado pela DateTimeFormatInfo.CalendarWeekRule propriedade e é usado pelo calendário atual da cultura para determinar a regra da semana do calendário. O valor de enumeração também é usado como um parâmetro para o Calendar.GetWeekOfYear método .

As regras da semana do calendário dependem do System.DayOfWeek valor que indica o primeiro dia da semana, além de depender de um CalendarWeekRule valor. A DateTimeFormatInfo.FirstDayOfWeek propriedade fornece o valor padrão para uma cultura, mas qualquer DayOfWeek valor pode ser especificado como o primeiro dia da semana no Calendar.GetWeekOfYear método .

A primeira semana com base no FirstDay valor pode ter de um a sete dias. A primeira semana com base no FirstFullWeek valor sempre tem sete dias. A primeira semana com base no FirstFourDayWeek valor pode ter de quatro a sete dias.

Por exemplo, no calendário gregoriano, suponha que o primeiro dia do ano (1º de janeiro) caia em uma terça-feira e o primeiro dia designado da semana seja domingo. A seleção FirstFullWeek define o primeiro domingo (6 de janeiro) como o início da primeira semana do ano. Os primeiros cinco dias do ano são considerados parte da última semana do ano anterior. Por outro lado, a seleção FirstFourDayWeek define o primeiro dia do ano (1º de janeiro) como o início da primeira semana do ano porque há mais de quatro dias de 1º de janeiro até o dia anterior ao domingo seguinte.

Suponha que o primeiro dia do ano (1º de janeiro) caia em uma sexta-feira e o primeiro dia designado da semana seja domingo. A seleção FirstFourDayWeek define o primeiro domingo (3 de janeiro) como o início da primeira semana do ano porque há menos de quatro dias de 1º de janeiro até o dia anterior ao domingo seguinte.

O exemplo a seguir ilustra como os CalendarWeekRule valores e DayOfWeek são usados juntos para determinar como as semanas são atribuídas. No calendário gregoriano, o primeiro dia do ano (1º de janeiro) em 2013 cai em uma terça-feira. Se o primeiro dia designado da semana for domingo, o primeiro domingo (6 de janeiro) será o primeiro dia da primeira semana do ano e o sábado (5 de janeiro) pertence à 53ª semana do ano anterior. Alterar a regra da semana do calendário para FirstFourDayWeek define terça-feira (1º de janeiro) como o início da primeira semana do ano, pois há mais de quatro dias entre terça-feira, 1º de janeiro e domingo, 6 de janeiro. Usando essa regra, 5 de janeiro pertence à primeira semana do ano. Para 2010, um ano em que 1º de janeiro cai em uma sexta-feira, aplicando a FirstFourDayWeek regra com DayOfWeek.Sunday como o primeiro dia da semana torna domingo, 3 de janeiro, o início da primeira semana do ano, porque a primeira semana em 2010 que tem mais de quatro dias é de 3 a 9 de janeiro.

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

Cada CultureInfo objeto dá suporte a um conjunto de calendários. A Calendar propriedade retorna o calendário padrão para a cultura e a OptionalCalendars propriedade retorna uma matriz que contém todos os calendários compatíveis com a cultura. Para alterar o calendário usado por um CultureInfo, defina a Calendar propriedade de CultureInfo.DateTimeFormat como um novo Calendar.

Aplica-se a

Confira também

• Calendar
• OptionalCalendars