Exporter (0) Imprimer
Développer tout

Calendar.GetWeekOfYear, méthode

Retourne la semaine de l'année qui contient la date du DateTime spécifié.

Espace de noms : System.Globalization
Assembly : mscorlib (dans mscorlib.dll)

public virtual int GetWeekOfYear (
	DateTime time,
	CalendarWeekRule rule,
	DayOfWeek firstDayOfWeek
)
public int GetWeekOfYear (
	DateTime time, 
	CalendarWeekRule rule, 
	DayOfWeek firstDayOfWeek
)
public function GetWeekOfYear (
	time : DateTime, 
	rule : CalendarWeekRule, 
	firstDayOfWeek : DayOfWeek
) : int

Paramètres

time

DateTime à lire.

rule

Valeur CalendarWeekRule qui définit une semaine calendrier.

firstDayOfWeek

Valeur DayOfWeek qui représente le premier jour de la semaine.

Valeur de retour

Entier positif qui représente la semaine de l'année qui inclut la date dans le paramètre time.

Type d'exceptionCondition

ArgumentOutOfRangeException

firstDayOfWeek sort de la plage prise en charge par le calendrier.

- ou -

rule n'est pas une valeur CalendarWeekRule valide.

Cette méthode permet de déterminer le nombre de semaines d'une année en assignant le dernier jour de l'année au paramètre time.

La propriété CultureInfo.DateTimeFormat contient des valeurs spécifiques à la culture qui peuvent être utilisées pour rule et firstDayOfWeek.

La propriété FirstDayOfWeek de CultureInfo.DateTimeFormat contient la valeur DayOfWeek par défaut qui représente le premier jour de la semaine pour une culture spécifique à l'aide du calendrier spécifié dans la propriété Calendar de CultureInfo.DateTimeFormat.

La propriété CalendarWeekRule de CultureInfo.DateTimeFormat contient la valeur CalendarWeekRule par défaut qui définit une semaine de calendrier pour une culture spécifique à l'aide du calendrier spécifié dans la propriété Calendar de CultureInfo.DateTimeFormat.

Par exemple, dans GregorianCalendar, la méthode GetWeekOfYear pour le 1er janvier retourne 1.

L'exemple de code suivant montre comment varie le résultat de GetWeekOfYear en fonction du FirstDayOfWeek et du CalendarWeekRule utilisés. Si la date spécifiée est le dernier jour de l'année, GetWeekOfYear retourne le nombre total de semaines dans cette année.

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).

*/

import System.* ;
import System.Globalization.* ;

public class SamplesCalendar
{
    public static void main(String[] args)
    {
        // Gets the Calendar instance associated with a CultureInfo.
        CultureInfo myCI =  new CultureInfo("en-US");
        Calendar myCal = myCI.get_Calendar();

        // Gets the DTFI properties required by GetWeekOfYear.
        CalendarWeekRule myCWR = 
            myCI.get_DateTimeFormat().get_CalendarWeekRule();
        DayOfWeek myFirstDOW = myCI.get_DateTimeFormat().get_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.", System.Convert.ToString( myCal.GetWeekOfYear(
            DateTime.get_Now(),myCWR, myFirstDOW)));

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

/*
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 15 of the current year.
There are 53 weeks in the current year (2004).
*/

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft