HebrewCalendar Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente le calendrier hébreu.
public ref class HebrewCalendar : System::Globalization::Calendar
public class HebrewCalendar : System.Globalization.Calendar
[System.Serializable]
public class HebrewCalendar : System.Globalization.Calendar
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class HebrewCalendar : System.Globalization.Calendar
type HebrewCalendar = class
inherit Calendar
[<System.Serializable>]
type HebrewCalendar = class
inherit Calendar
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type HebrewCalendar = class
inherit Calendar
Public Class HebrewCalendar
Inherits Calendar
- Héritage
- Attributs
Exemples
L’exemple suivant crée un fichier qui contient les plages de dates prises en charge par la HebrewCalendar classe et affiche le nombre de jours dans chaque mois de l’année 5772.
using System;
using System.Globalization;
using System.IO;
using System.Threading;
public class Example
{
public static void Main()
{
StreamWriter output = new StreamWriter("HebrewCalendarInfo.txt");
// Make the Hebrew Calendar the current calendar and
// Hebrew (Israel) the current thread culture.
HebrewCalendar hc = new HebrewCalendar();
CultureInfo culture = CultureInfo.CreateSpecificCulture("he-IL");
culture.DateTimeFormat.Calendar = hc;
Thread.CurrentThread.CurrentCulture = culture;
output.WriteLine("{0} Information:\n",
GetCalendarName(culture.DateTimeFormat.Calendar));
// Get the calendar range expressed in both Hebrew calendar and
// Gregorian calendar dates.
output.WriteLine("Start Date: {0} ", hc.MinSupportedDateTime);
culture.DateTimeFormat.Calendar = culture.Calendar;
output.WriteLine(" ({0} Gregorian)\n",
hc.MinSupportedDateTime);
culture.DateTimeFormat.Calendar = hc;
output.WriteLine("End Date: {0} ", hc.MaxSupportedDateTime);
culture.DateTimeFormat.Calendar = culture.Calendar;
output.WriteLine(" ({0} Gregorian)\n",
hc.MaxSupportedDateTime);
culture.DateTimeFormat.Calendar = hc;
// Get the year in the Hebrew calendar that corresponds to 1/1/2012
// and display information about it.
DateTime startOfYear = new DateTime(2012, 1, 1);
output.WriteLine("Days in the Year {0}: {1}\n",
hc.GetYear(startOfYear),
hc.GetDaysInYear(hc.GetYear(startOfYear)));
output.WriteLine("Days in Each Month of {0}:\n", hc.GetYear(startOfYear));
output.WriteLine("Month Days Month Name");
// Change start of year to first day of first month
startOfYear = hc.ToDateTime(hc.GetYear(startOfYear), 1, 1, 0, 0, 0, 0);
DateTime startOfMonth = startOfYear;
for (int ctr = 1; ctr <= hc.GetMonthsInYear(hc.GetYear(startOfYear)); ctr++) {
output.Write(" {0,2}", ctr);
output.WriteLine("{0,12}{1,15:MMM}",
hc.GetDaysInMonth(hc.GetYear(startOfMonth), hc.GetMonth(startOfMonth)),
startOfMonth);
startOfMonth = hc.AddMonths(startOfMonth, 1);
}
output.Close();
}
private static string GetCalendarName(Calendar cal)
{
return cal.ToString().Replace("System.Globalization.", "").Replace("Cal", " Cal");
}
}
// The example displays the following output:
// Hebrew Calendar Information:
//
// Start Date: ז// טבת שמ"ג 00:00:00
// (01/01/1583 00:00:00 Gregorian)
//
// End Date: כ"ט אלול תתקצ"ט 23:59:59
// (29/09/2239 23:59:59 Gregorian)
//
// Days in the Year 5772: 354
//
// Days in Each Month of 5772:
//
// Month Days Month Name
// 1 30 תשרי
// 2 29 חשון
// 3 30 כסלו
// 4 29 טבת
// 5 30 שבט
// 6 29 אדר
// 7 30 ניסן
// 8 29 אייר
// 9 30 סיון
// 10 29 תמוז
// 11 30 אב
// 12 29 אלול
Imports System.Globalization
Imports System.IO
Imports System.Threading
Module Example
Public Sub Main()
Dim output As New StreamWriter("HebrewCalendarInfo.txt")
' Make the Hebrew Calendar the current calendar and
' Hebrew (Israel) the current thread culture.
Dim hc As New HebrewCalendar()
Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("he-IL")
culture.DateTimeFormat.Calendar = hc
Thread.CurrentThread.CurrentCulture = culture
output.WriteLine("{0} Information:",
GetCalendarName(culture.DateTimeFormat.Calendar))
output.WriteLine()
' Get the calendar range expressed in both Hebrew calendar and
' Gregorian calendar dates.
output.WriteLine("Start Date: {0} ",
hc.MinSupportedDateTime)
culture.DateTimeFormat.Calendar = culture.Calendar
output.WriteLine(" ({0} Gregorian)",
hc.MinSupportedDateTime)
output.WriteLine()
culture.DateTimeFormat.Calendar = hc
output.WriteLine("End Date: {0} ",
hc.MaxSupportedDateTime)
culture.DateTimeFormat.Calendar = culture.Calendar
output.WriteLine(" ({0} Gregorian)",
hc.MaxSupportedDateTime)
output.WriteLine()
culture.DateTimeFormat.Calendar = hc
' Get the year in the Hebrew calendar that corresponds to 1/1/2012
' and display information about it.
Dim startOfYear As Date = #1/1/2012#
output.WriteLine("Days in the Year {0}: {1}",
hc.GetYear(startOfYear),
hc.GetDaysInYear(hc.GetYear(startOfYear)))
output.WriteLine()
output.WriteLine("Days in Each Month of {0}:", hc.GetYear(startOfYear))
output.WriteLine()
output.WriteLine("Month Days Month Name")
' Change start of year to first day of first month
startOfYear = hc.ToDateTime(hc.GetYear(startOfYear), 1, 1, 0, 0, 0, 0)
Dim startOfMonth As Date = startOfYear
For ctr As Integer = 1 To hc.GetMonthsInYear(hc.GetYear(startOfYear))
output.Write(" {0,2}", ctr)
output.WriteLine("{0,12}{1,15:MMM}",
hc.GetDaysInMonth(hc.GetYear(startOfMonth), hc.GetMonth(startOfMonth)),
startOfMonth)
startOfMonth = hc.AddMonths(startOfMonth, 1)
Next
output.Close()
End Sub
Private Function GetCalendarName(cal As Calendar) As String
Return cal.ToString().Replace("System.Globalization.", "").Replace("Cal", " Cal")
End Function
End Module
' The example displays the following output:
' Hebrew Calendar Information:
'
' Start Date: ז' טבת שמ"ג 00:00:00
' (01/01/1583 00:00:00 Gregorian)
'
' End Date: כ"ט אלול תתקצ"ט 23:59:59
' (29/09/2239 23:59:59 Gregorian)
'
' Days in the Year 5772: 354
'
' Days in Each Month of 5772:
'
' Month Days Month Name
' 1 30 תשרי
' 2 29 חשון
' 3 30 כסלו
' 4 29 טבת
' 5 30 שבט
' 6 29 אדר
' 7 30 ניסן
' 8 29 אייר
' 9 30 סיון
' 10 29 תמוז
' 11 30 אב
' 12 29 אלול
L’exemple instancie un HebrewCalendar objet et le rend le calendrier actuel d’un objet hébreu (Israël). CultureInfo Il fait ensuite l’hébreu (Israël) la culture actuelle. Ainsi, le Common Language Runtime interprète toutes les dates et toutes les heures par rapport au calendrier hébreu.
Remarques
Le calendrier hébreu reconnaît deux ères : B.C.E. (avant l’ère commune) et A.M. (latin « Anno Mund », ce qui signifie « l’année du monde »). Cette implémentation de la HebrewCalendar classe reconnaît uniquement l’ère actuelle (A.M.) et les années hébraïques 5343 à 5999 (1583 à 2239 dans le calendrier grégorien).
Note
Pour plus d’informations sur l’utilisation de la HebrewCalendar classe et les autres classes de calendrier dans .NET Framework, consultez Utilisation des calendriers.
Dans chaque cycle de 19 ans qui se termine par une année uniformément divisible par 19, les 3e, 6e, 8e, 11e, 14e, 17e et 19e années sont des années bissextiles. Une année commune peut avoir entre 353 et 355 jours, selon le placement des vacances juives. Une année bissextile peut avoir de 383 à 385 jours.
Le calendrier hébreu a 12 mois pendant les années communes et 13 mois pendant les années bissextiles :
| Valeur GetMonth (année commune) | Valeur GetMonth (année bissextile) | Mois | Jours dans les années courantes | Jours dans les années bissextiles |
|---|---|---|---|---|
| 1 | 1 | שיי (Tishrei) | 30 | 30 |
| 2 | 2 | חשן (Cheshvan) | 29/30 | 29/30 |
| 3 | 3 | כסלו (Kislev) | 29/30 | 29/30 |
| 4 | 4 | טט | 29 | 29 |
| 5 | 5 | שט (Shevat) | 30 | 30 |
| 6 | - | דד | 29 | - |
| - | 6 | ד א (Adar Alef) | - | 30 |
| - | 7 | ד ב (Adar Beit) | - | 29 |
| 7 | 8 | ניסן (Nissan) | 30 | 30 |
| 8 | 9 | תיי (Iyar) | 29 | 29 |
| 9 | 10 | סיין (Sivan) | 30 | 30 |
| 10 | 11 | ז ז (Tamuz) | 29 | 29 |
| 11 | 12 | ...), (« Av ») | 30 | 30 |
| 12 | 13 | ללל (Elul) | 29 | 29 |
Les jours à Cheshvan et Kislev varient selon le placement des vacances juives. Pendant les années bissextiles, Adar est remplacé par Adar Alef avec 30 jours et Adar Beit avec 29 jours. Adar Alef est considéré comme le mois bissextile. Le dernier jour d’Adar Alef et tous les jours à Adar Beit sont considérés comme des jours bissextiles ; autrement dit, la IsLeapDay méthode retourne true pour ces jours.
La date du 1er janvier 2001 dans le calendrier grégorien équivaut au sixième jour de Tevet dans l’année 5761 A.M. dans le calendrier hébreu.
Chacun CultureInfo prend en charge un ensemble de calendriers. La Calendar propriété retourne le calendrier par défaut de la culture, et la OptionalCalendars propriété retourne un tableau contenant tous les calendriers pris en charge par la culture. Pour modifier le calendrier utilisé par un CultureInfo, l’application doit définir la Calendar propriété sur CultureInfo.DateTimeFormat un nouveau Calendar.
Constructeurs
| Nom | Description |
|---|---|
| HebrewCalendar() |
Initialise une nouvelle instance de la classe HebrewCalendar. |
Champs
| Nom | Description |
|---|---|
| CurrentEra |
Représente l’ère actuelle du calendrier actuel. La valeur de ce champ est 0. (Hérité de Calendar) |
| HebrewEra |
Représente l’ère actuelle. Ce champ est constant. |
Propriétés
| Nom | Description |
|---|---|
| AlgorithmType |
Obtient une valeur qui indique si le calendrier actuel est basé sur le soleil, lunaire ou une combinaison des deux. |
| DaysInYearBeforeMinSupportedYear |
Obtient le nombre de jours de l’année qui précède l’année spécifiée par la MinSupportedDateTime propriété. (Hérité de Calendar) |
| Eras |
Obtient la liste des ères dans le HebrewCalendar. |
| IsReadOnly |
Obtient une valeur indiquant si cet Calendar objet est en lecture seule. (Hérité de Calendar) |
| MaxSupportedDateTime |
Obtient la date et l’heure les plus récentes prises en charge par le HebrewCalendar type. |
| MinSupportedDateTime |
Obtient la date et l’heure les plus anciennes prises en charge par le HebrewCalendar type. |
| TwoDigitYearMax |
Obtient ou définit la dernière année d’une plage de 100 ans qui peut être représentée par une année à 2 chiffres. |
Méthodes
| Nom | Description |
|---|---|
| AddDays(DateTime, Int32) |
Retourne un DateTime nombre spécifié de jours à partir de l’objet spécifié DateTime. (Hérité de Calendar) |
| AddHours(DateTime, Int32) |
Retourne un DateTime nombre spécifié d’heures à partir de l’objet spécifié DateTime. (Hérité de Calendar) |
| AddMilliseconds(DateTime, Double) |
Retourne un DateTime nombre spécifié de millisecondes à partir du nombre spécifié DateTime. (Hérité de Calendar) |
| AddMinutes(DateTime, Int32) |
Retourne un DateTime nombre spécifié de minutes à partir de l’objet spécifié DateTime. (Hérité de Calendar) |
| AddMonths(DateTime, Int32) |
Retourne un DateTime nombre spécifié de mois à partir du nombre spécifié DateTime. |
| AddSeconds(DateTime, Int32) |
Retourne un DateTime nombre spécifié de secondes à partir de l’objet spécifié DateTime. (Hérité de Calendar) |
| AddWeeks(DateTime, Int32) |
Retourne un DateTime nombre spécifié de semaines à partir de l’objet spécifié DateTime. (Hérité de Calendar) |
| AddYears(DateTime, Int32) |
Retourne un DateTime nombre spécifié d’années à partir de l’objet spécifié DateTime. |
| Clone() |
Crée un objet qui est une copie de l’objet actif Calendar . (Hérité de Calendar) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetDayOfMonth(DateTime) |
Retourne le jour du mois dans le fichier spécifié DateTime. |
| GetDayOfWeek(DateTime) |
Retourne le jour de la semaine dans le fichier spécifié DateTime. |
| GetDayOfYear(DateTime) |
Retourne le jour de l’année dans le fichier spécifié DateTime. |
| GetDaysInMonth(Int32, Int32, Int32) |
Retourne le nombre de jours dans le mois spécifié dans l’année spécifiée dans l’ère spécifiée. |
| GetDaysInMonth(Int32, Int32) |
Retourne le nombre de jours dans le mois et l’année spécifiés de l’ère actuelle. (Hérité de Calendar) |
| GetDaysInYear(Int32, Int32) |
Retourne le nombre de jours dans l’année spécifiée dans l’ère spécifiée. |
| GetDaysInYear(Int32) |
Retourne le nombre de jours dans l’année spécifiée de l’ère actuelle. (Hérité de Calendar) |
| GetEra(DateTime) |
Retourne l’ère dans le fichier spécifié DateTime. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetHour(DateTime) |
Retourne la valeur d’heures dans le fichier spécifié DateTime. (Hérité de Calendar) |
| GetLeapMonth(Int32, Int32) |
Calcule le mois bissextile pour une année et une ère spécifiées. |
| GetLeapMonth(Int32) |
Calcule le mois bissextile pour une année spécifiée. (Hérité de Calendar) |
| GetMilliseconds(DateTime) |
Retourne la valeur de millisecondes dans le fichier spécifié DateTime. (Hérité de Calendar) |
| GetMinute(DateTime) |
Retourne la valeur minutes dans le fichier spécifié DateTime. (Hérité de Calendar) |
| GetMonth(DateTime) |
Retourne le mois dans le fichier spécifié DateTime. |
| GetMonthsInYear(Int32, Int32) |
Retourne le nombre de mois de l’année spécifiée dans l’ère spécifiée. |
| GetMonthsInYear(Int32) |
Retourne le nombre de mois dans l’année spécifiée dans l’ère actuelle. (Hérité de Calendar) |
| GetSecond(DateTime) |
Retourne la valeur de secondes dans le fichier spécifié DateTime. (Hérité de Calendar) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Retourne la semaine de l’année qui inclut la date dans la valeur spécifiée DateTime . (Hérité de Calendar) |
| GetYear(DateTime) |
Retourne l’année dans la valeur spécifiée DateTime . |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Détermine si la date spécifiée dans l’ère spécifiée est un jour bissextile. |
| IsLeapDay(Int32, Int32, Int32) |
Détermine si la date spécifiée dans l’ère actuelle est un jour bissextile. (Hérité de Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Détermine si le mois spécifié dans l’année spécifiée dans l’ère spécifiée est un mois bissextile. |
| IsLeapMonth(Int32, Int32) |
Détermine si le mois spécifié dans l’année spécifiée dans l’ère actuelle est un mois bissextile. (Hérité de Calendar) |
| IsLeapYear(Int32, Int32) |
Détermine si l’année spécifiée dans l’ère spécifiée est une année bissextile. |
| IsLeapYear(Int32) |
Détermine si l’année spécifiée dans l’ère actuelle est une année bissextile. (Hérité de Calendar) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Retourne une DateTime valeur définie sur la date et l’heure spécifiées dans l’ère spécifiée. |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Retourne une DateTime valeur définie sur la date et l’heure spécifiées dans l’ère actuelle. (Hérité de Calendar) |
| ToFourDigitYear(Int32) |
Convertit l’année spécifiée en année à 4 chiffres à l’aide de la TwoDigitYearMax propriété pour déterminer le siècle approprié. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |