HebrewCalendar Classe

Definição

Representa o calendário hebraico.

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
Herança
HebrewCalendar
Atributos

Exemplos

O exemplo seguinte cria um ficheiro que contém os intervalos de datas suportados pela HebrewCalendar classe e mostra o número de dias em cada mês do ano 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           אלול

O exemplo instancia um HebrewCalendar objeto e torna-o o calendário atual de um objeto hebraico (Israel CultureInfo ). Depois, faz do hebraico (Israel) a cultura atual. Isto faz com que o runtime da linguagem comum interprete todas as datas e horas em relação ao calendário hebraico.

Observações

O calendário hebraico reconhece duas eras: a.C. (antes da era comum) e A.M. (latim "Anno Mundi", que significa "o ano do mundo"). Esta implementação da HebrewCalendar classe reconhece apenas a era atual (A.M.) e os anos hebraicos de 5343 a 5999 (1583 a 2239 no calendário gregoriano).

Note

Para informações sobre a utilização da classe HebrewCalendar e das outras classes de calendário no .NET Framework, veja Trabalhar com Calendários.

Em cada ciclo de 19 anos que termina com um ano divisível igualmente por 19, o 3.º, 6.º, 8.º, 11.º, 14.º, 17.º e 19.º anos são anos bissextos. Um ano comum pode ter entre 353 e 355 dias, dependendo da localização dos feriados judaicos. Um ano bissexto pode ter entre 383 e 385 dias.

O calendário hebraico tem 12 meses durante os anos comuns e 13 meses durante os anos bissextos:

Valor GetMonth (ano comum) Valor GetMonth (ano bissexto) Mês Dias em anos comuns Dias em anos bissextos
1 1 תשרי (Tishrei) 30 30
2 2 חשון (Cheshvan) 29/30 29/30
3 3 כסלו (Kislev) 29/30 29/30
4 4 טבת (Tevet) 29 29
5 5 שבט (Shevat) 30 30
6 - אדר (Adar) 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

Os dias em Cheshvan e Kislev variam consoante a localização dos feriados judaicos. Durante os anos bissextos, Adar é substituído por Adar Alef com 30 dias e Adar Beit com 29 dias. Adar Alef é considerado o mês bissexto. O último dia de Adar Alef e todos os dias em Adar Beit são considerados dias bissextos; Ou seja, o IsLeapDay método regressa true nestes dias.

A data 1 de janeiro de 2001 d.C. no calendário gregoriano equivale ao sexto dia de Tevet no ano 5761 A.M. no calendário hebraico.

Cada um CultureInfo suporta um conjunto de calendários. A Calendar propriedade devolve o calendário padrão da cultura, e a OptionalCalendars propriedade devolve um array contendo todos os calendários suportados pela cultura. Para alterar o calendário usado por um CultureInfo, a aplicação deve definir a Calendar propriedade de CultureInfo.DateTimeFormat para um novo Calendar.

Construtores

Name Description
HebrewCalendar()

Inicializa uma nova instância da HebrewCalendar classe.

Campos

Name Description
CurrentEra

Representa a era atual do calendário atual. O valor deste campo é 0.

(Herdado de Calendar)
HebrewEra

Representa a era atual. Este campo é constante.

Propriedades

Name Description
AlgorithmType

Recebe um valor que indica se o calendário atual é baseado em energia solar, lunar ou uma combinação de ambos.

DaysInYearBeforeMinSupportedYear

Obtém o número de dias no ano anterior ao ano especificado pela MinSupportedDateTime propriedade.

(Herdado de Calendar)
Eras

Obtém a lista de eras no HebrewCalendar.

IsReadOnly

Recebe um valor que indica se este Calendar objeto é apenas de leitura.

(Herdado de Calendar)
MaxSupportedDateTime

Recebe a data e hora mais recentes apoiadas pelo HebrewCalendar tipo.

MinSupportedDateTime

Obtém a data e hora mais antigas apoiadas pelo HebrewCalendar tipo.

TwoDigitYearMax

Obtém ou define o último ano de um intervalo de 100 anos que pode ser representado por um ano de 2 dígitos.

Métodos

Name Description
AddDays(DateTime, Int32)

Devolve um DateTime que é o número de dias especificado a partir do especificado DateTime.

(Herdado de Calendar)
AddHours(DateTime, Int32)

Retorna um DateTime que é o número especificado de horas do especificado DateTime.

(Herdado de Calendar)
AddMilliseconds(DateTime, Double)

Devolve a DateTime que é o número especificado de milissegundos do especificado DateTime.

(Herdado de Calendar)
AddMinutes(DateTime, Int32)

Devolve a DateTime que é o número especificado de minutos do especificado DateTime.

(Herdado de Calendar)
AddMonths(DateTime, Int32)

Devolve um DateTime que é o número de meses especificado a partir do especificado DateTime.

AddSeconds(DateTime, Int32)

Retorna a DateTime que é o número especificado de segundos a partir do especificado DateTime.

(Herdado de Calendar)
AddWeeks(DateTime, Int32)

Devolve um DateTime que é o número especificado de semanas a partir do especificado DateTime.

(Herdado de Calendar)
AddYears(DateTime, Int32)

Devolve um DateTime que é o número de anos especificado a partir do especificado DateTime.

Clone()

Cria um novo objeto que é uma cópia do objeto atual Calendar .

(Herdado de Calendar)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetDayOfMonth(DateTime)

Devolve no dia do mês no especificado DateTime.

GetDayOfWeek(DateTime)

Devolve no dia da semana no especificado DateTime.

GetDayOfYear(DateTime)

Devolve o dia do ano no especificado DateTime.

GetDaysInMonth(Int32, Int32, Int32)

Devolve o número de dias no mês especificado, no ano especificado na era especificada.

GetDaysInMonth(Int32, Int32)

Devolve o número de dias no mês e ano especificados da era atual.

(Herdado de Calendar)
GetDaysInYear(Int32, Int32)

Devolve o número de dias no ano especificado na era especificada.

GetDaysInYear(Int32)

Devolve o número de dias no ano especificado da era atual.

(Herdado de Calendar)
GetEra(DateTime)

Devolve a era no especificado DateTime.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetHour(DateTime)

Devolve o valor das horas no especificado DateTime.

(Herdado de Calendar)
GetLeapMonth(Int32, Int32)

Calcula o mês bissexto para um ano e era especificados.

GetLeapMonth(Int32)

Calcula o mês bissexto para um ano especificado.

(Herdado de Calendar)
GetMilliseconds(DateTime)

Devolve o valor de milissegundos no especificado DateTime.

(Herdado de Calendar)
GetMinute(DateTime)

Devolve o valor dos minutos no especificado DateTime.

(Herdado de Calendar)
GetMonth(DateTime)

Devolve no mês especificado DateTime.

GetMonthsInYear(Int32, Int32)

Devolve o número de meses do ano especificado na era especificada.

GetMonthsInYear(Int32)

Devolve o número de meses do ano especificado na era atual.

(Herdado de Calendar)
GetSecond(DateTime)

Devolve o valor dos segundos no especificado DateTime.

(Herdado de Calendar)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)

Devolve a semana do ano que inclui a data no valor especificado DateTime .

(Herdado de Calendar)
GetYear(DateTime)

Devolve o ano no valor especificado DateTime .

IsLeapDay(Int32, Int32, Int32, Int32)

Determina se a data especificada na era especificada é um dia bissexto.

IsLeapDay(Int32, Int32, Int32)

Determina se a data especificada na era atual é um dia bissexto.

(Herdado de Calendar)
IsLeapMonth(Int32, Int32, Int32)

Determina se o mês especificado no ano especificado na era especificada é um mês bissexto.

IsLeapMonth(Int32, Int32)

Determina se o mês especificado no ano especificado na era atual é um mês bissexto.

(Herdado de Calendar)
IsLeapYear(Int32, Int32)

Determina se o ano especificado na era especificada é um ano bissexto.

IsLeapYear(Int32)

Determina se o ano especificado na era atual é um ano bissexto.

(Herdado de Calendar)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Devolve a DateTime que está definido para a data e hora especificadas na era especificada.

ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Devolve a DateTime que está definido para a data e hora especificadas na era atual.

(Herdado de Calendar)
ToFourDigitYear(Int32)

Converte o ano especificado num ano de 4 dígitos, utilizando a TwoDigitYearMax propriedade para determinar o século apropriado.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também