JapaneseCalendar.GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) Methode

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

JapaneseCalendar.cs

Gibt die Woche des Jahres zurück, in die das Datum in der angegebenen DateTime fällt.

public:
 override int GetWeekOfYear(DateTime time, System::Globalization::CalendarWeekRule rule, DayOfWeek firstDayOfWeek);

public override int GetWeekOfYear (DateTime time, System.Globalization.CalendarWeekRule rule, DayOfWeek firstDayOfWeek);

override this.GetWeekOfYear : DateTime * System.Globalization.CalendarWeekRule * DayOfWeek -> int

Public Overrides Function GetWeekOfYear (time As DateTime, rule As CalendarWeekRule, firstDayOfWeek As DayOfWeek) As Integer

Parameter

time

DateTime

Die zu lesende DateTime.

rule

CalendarWeekRule

Einer der CalendarWeekRule-Werte, die eine Kalenderwoche definieren.

firstDayOfWeek

DayOfWeek

Einer der DayOfWeek-Werte, die den ersten Tag der Woche darstellen.

Gibt zurück

Int32

Eine ganze Zahl mit der Basis 1, die die Woche des Jahres darstellt, in die das Datum im time-Parameter fällt.

Ausnahmen

ArgumentOutOfRangeException

time oder firstDayOfWeek liegt außerhalb des Bereichs, der vom Kalender unterstützt wird.

- oder -

rule ist kein gültiger CalendarWeekRule -Wert.

Beispiele

Das folgende Codebeispiel zeigt, wie das Ergebnis von abhängig von GetWeekOfYear den FirstDayOfWeek verwendeten Werten und CalendarWeekRule variiert. Wenn das angegebene Datum der letzte Tag des Jahres ist, GetWeekOfYear gibt die Gesamtzahl der Wochen in diesem Jahr zurück.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Gets the Calendar instance associated with a CultureInfo.
   CultureInfo^ myCI = gcnew CultureInfo( "en-US" );
   Calendar^ myCal = myCI->Calendar;
   
   // Gets the DTFI properties required by GetWeekOfYear.
   CalendarWeekRule myCWR = myCI->DateTimeFormat->CalendarWeekRule;
   DayOfWeek myFirstDOW = myCI->DateTimeFormat->FirstDayOfWeek;
   
   // Displays the number of the current week relative to the beginning of the year.
   Console::WriteLine( "The CalendarWeekRule used for the en-US culture is {0}.", myCWR );
   Console::WriteLine( "The FirstDayOfWeek used for the en-US culture is {0}.", myFirstDOW );
   Console::WriteLine( "Therefore, the current week is Week {0} of the current year.", myCal->GetWeekOfYear( DateTime::Now, myCWR, myFirstDOW ) );
   
   // Displays the total number of weeks in the current year.
   DateTime LastDay = System::DateTime( DateTime::Now.Year, 12, 31 );
   Console::WriteLine( "There are {0} weeks in the current year ( {1}).", myCal->GetWeekOfYear( LastDay, myCWR, myFirstDOW ), LastDay.Year );
}

/*
This code produces the following output.  Results vary depending on the system date.

The CalendarWeekRule used for the en-US culture is FirstDay.
The FirstDayOfWeek used for the en-US culture is Sunday.
Therefore, the current week is Week 1 of the current year.
There are 53 weeks in the current year (2001).
*/

using System;
using System.Globalization;

public class SamplesCalendar  {

   public static void Main()  {

      // Gets the Calendar instance associated with a CultureInfo.
      CultureInfo myCI = new CultureInfo("en-US");
      Calendar myCal = myCI.Calendar;

      // Gets the DTFI properties required by GetWeekOfYear.
      CalendarWeekRule myCWR = myCI.DateTimeFormat.CalendarWeekRule;
      DayOfWeek myFirstDOW = myCI.DateTimeFormat.FirstDayOfWeek;

      // Displays the number of the current week relative to the beginning of the year.
      Console.WriteLine( "The CalendarWeekRule used for the en-US culture is {0}.", myCWR );
      Console.WriteLine( "The FirstDayOfWeek used for the en-US culture is {0}.", myFirstDOW );
      Console.WriteLine( "Therefore, the current week is Week {0} of the current year.", myCal.GetWeekOfYear( DateTime.Now, myCWR, myFirstDOW ));

      // Displays the total number of weeks in the current year.
      DateTime LastDay = new System.DateTime( DateTime.Now.Year, 12, 31 );
      Console.WriteLine( "There are {0} weeks in the current year ({1}).", myCal.GetWeekOfYear( LastDay, myCWR, myFirstDOW ), LastDay.Year );
   }
}

/*
This code produces the following output.  Results vary depending on the system date.

The CalendarWeekRule used for the en-US culture is FirstDay.
The FirstDayOfWeek used for the en-US culture is Sunday.
Therefore, the current week is Week 1 of the current year.
There are 53 weeks in the current year (2001).

*/

Imports System.Globalization

Public Class SamplesCalendar

   Public Shared Sub Main()
      
      ' Gets the Calendar instance associated with a CultureInfo.
      Dim myCI As New CultureInfo("en-US")
      Dim myCal As Calendar = myCI.Calendar
      
      ' Gets the DTFI properties required by GetWeekOfYear.
      Dim myCWR As CalendarWeekRule = myCI.DateTimeFormat.CalendarWeekRule
      Dim myFirstDOW As DayOfWeek = myCI.DateTimeFormat.FirstDayOfWeek
      
      ' Displays the number of the current week relative to the beginning of the year.
      Console.WriteLine("The CalendarWeekRule used for the en-US culture is {0}.", myCWR)
      Console.WriteLine("The FirstDayOfWeek used for the en-US culture is {0}.", myFirstDOW)
      Console.WriteLine("Therefore, the current week is Week {0} of the current year.", myCal.GetWeekOfYear(DateTime.Now, myCWR, myFirstDOW))
      
      ' Displays the total number of weeks in the current year.
      Dim LastDay = New System.DateTime(DateTime.Now.Year, 12, 31)
      Console.WriteLine("There are {0} weeks in the current year ({1}).", myCal.GetWeekOfYear(LastDay, myCWR, myFirstDOW), LastDay.Year)
   End Sub
End Class


'This code produces the following output.  Results vary depending on the system date.
'
'The CalendarWeekRule used for the en-US culture is FirstDay.
'The FirstDayOfWeek used for the en-US culture is Sunday.
'Therefore, the current week is Week 1 of the current year.
'There are 53 weeks in the current year (2001).

Hinweise

Diese Methode kann verwendet werden, um die Anzahl der Wochen im Jahr zu bestimmen, indem der time Parameter auf den letzten Tag des Jahres festgelegt wird.

Die CultureInfo.DateTimeFormat -Eigenschaft enthält kulturspezifische Werte, die für die rule Parameter und firstDayOfWeek verwendet werden können.

Die FirstDayOfWeek -Eigenschaft von CultureInfo.DateTimeFormat enthält den Standardwert DayOfWeek , der den ersten Wochentag für eine bestimmte Kultur darstellt, wobei der in der Calendar -Eigenschaft CultureInfo.DateTimeFormatangegebene Kalender verwendet wird.

Die CalendarWeekRule Eigenschaft von CultureInfo.DateTimeFormat enthält den Standardwert CalendarWeekRule , der eine Kalenderwoche für eine bestimmte Kultur definiert, wobei der in der Calendar -Eigenschaft CultureInfo.DateTimeFormatangegebene Kalender verwendet wird.

Beispielsweise gibt die GregorianCalendar-Methode für den GetWeekOfYear 1. Januar 1 zurück.