Calendar Sınıf

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Calendar.cs

Haftalar, aylar ve yıllar gibi bölümler halindeki zamanı temsil eder.

public ref class Calendar abstract : ICloneable

public abstract class Calendar : ICloneable

type Calendar = class
    interface ICloneable

Public MustInherit Class Calendar
Implements ICloneable

Devralma

Object

Calendar

Türetilmiş

System.Globalization.EastAsianLunisolarCalendar

System.Globalization.GregorianCalendar

System.Globalization.HebrewCalendar

System.Globalization.HijriCalendar

System.Globalization.JapaneseCalendar

System.Globalization.JulianCalendar

System.Globalization.KoreanCalendar

System.Globalization.PersianCalendar

System.Globalization.TaiwanCalendar

System.Globalization.ThaiBuddhistCalendar

System.Globalization.UmAlQuraCalendar

Uygulamalar

ICloneable

Örnekler

Aşağıdaki kod örneği sınıfın üyelerini Calendar gösterir.

using namespace System;
using namespace System::Globalization;
void DisplayValues( Calendar^ myCal, DateTime myDT )
{
   Console::WriteLine( "   Era: {0}", myCal->GetEra( myDT ) );
   Console::WriteLine( "   Year: {0}", myCal->GetYear( myDT ) );
   Console::WriteLine( "   Month: {0}", myCal->GetMonth( myDT ) );
   Console::WriteLine( "   DayOfYear: {0}", myCal->GetDayOfYear( myDT ) );
   Console::WriteLine( "   DayOfMonth: {0}", myCal->GetDayOfMonth( myDT ) );
   Console::WriteLine( "   DayOfWeek: {0}", myCal->GetDayOfWeek( myDT ) );
   Console::WriteLine( "   Hour: {0}", myCal->GetHour( myDT ) );
   Console::WriteLine( "   Minute: {0}", myCal->GetMinute( myDT ) );
   Console::WriteLine( "   Second: {0}", myCal->GetSecond( myDT ) );
   Console::WriteLine( "   Milliseconds: {0}", myCal->GetMilliseconds( myDT ) );
   Console::WriteLine();
}

int main()
{
   
   // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
   DateTime myDT = DateTime(2002,4,3,gcnew GregorianCalendar);
   
   // Uses the default calendar of the InvariantCulture.
   Calendar^ myCal = CultureInfo::InvariantCulture->Calendar;
   
   // Displays the values of the DateTime.
   Console::WriteLine( "April 3, 2002 of the Gregorian calendar:" );
   DisplayValues( myCal, myDT );
   
   // Adds 5 to every component of the DateTime.
   myDT = myCal->AddYears( myDT, 5 );
   myDT = myCal->AddMonths( myDT, 5 );
   myDT = myCal->AddWeeks( myDT, 5 );
   myDT = myCal->AddDays( myDT, 5 );
   myDT = myCal->AddHours( myDT, 5 );
   myDT = myCal->AddMinutes( myDT, 5 );
   myDT = myCal->AddSeconds( myDT, 5 );
   myDT = myCal->AddMilliseconds( myDT, 5 );
   
   // Displays the values of the DateTime.
   Console::WriteLine( "After adding 5 to each component of the DateTime:" );
   DisplayValues( myCal, myDT );
}

/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
Era:          1
Year:         2002
Month:        4
DayOfYear:    93
DayOfMonth:   3
DayOfWeek:    Wednesday
Hour:         0
Minute:       0
Second:       0
Milliseconds: 0

After adding 5 to each component of the DateTime:
Era:          1
Year:         2007
Month:        10
DayOfYear:    286
DayOfMonth:   13
DayOfWeek:    Saturday
Hour:         5
Minute:       5
Second:       5
Milliseconds: 5

*/

using System;
using System.Globalization;

public class SamplesCalendar  {

   public static void Main()  {

      // Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      DateTime myDT = new DateTime( 2002, 4, 3, new GregorianCalendar() );

      // Uses the default calendar of the InvariantCulture.
      Calendar myCal = CultureInfo.InvariantCulture.Calendar;

      // Displays the values of the DateTime.
      Console.WriteLine( "April 3, 2002 of the Gregorian calendar:" );
      DisplayValues( myCal, myDT );

      // Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears( myDT, 5 );
      myDT = myCal.AddMonths( myDT, 5 );
      myDT = myCal.AddWeeks( myDT, 5 );
      myDT = myCal.AddDays( myDT, 5 );
      myDT = myCal.AddHours( myDT, 5 );
      myDT = myCal.AddMinutes( myDT, 5 );
      myDT = myCal.AddSeconds( myDT, 5 );
      myDT = myCal.AddMilliseconds( myDT, 5 );

      // Displays the values of the DateTime.
      Console.WriteLine( "After adding 5 to each component of the DateTime:" );
      DisplayValues( myCal, myDT );
   }

   public static void DisplayValues( Calendar myCal, DateTime myDT )  {
      Console.WriteLine( "   Era:          {0}", myCal.GetEra( myDT ) );
      Console.WriteLine( "   Year:         {0}", myCal.GetYear( myDT ) );
      Console.WriteLine( "   Month:        {0}", myCal.GetMonth( myDT ) );
      Console.WriteLine( "   DayOfYear:    {0}", myCal.GetDayOfYear( myDT ) );
      Console.WriteLine( "   DayOfMonth:   {0}", myCal.GetDayOfMonth( myDT ) );
      Console.WriteLine( "   DayOfWeek:    {0}", myCal.GetDayOfWeek( myDT ) );
      Console.WriteLine( "   Hour:         {0}", myCal.GetHour( myDT ) );
      Console.WriteLine( "   Minute:       {0}", myCal.GetMinute( myDT ) );
      Console.WriteLine( "   Second:       {0}", myCal.GetSecond( myDT ) );
      Console.WriteLine( "   Milliseconds: {0}", myCal.GetMilliseconds( myDT ) );
      Console.WriteLine();
   }
}


/*
This code produces the following output.

April 3, 2002 of the Gregorian calendar:
   Era:          1
   Year:         2002
   Month:        4
   DayOfYear:    93
   DayOfMonth:   3
   DayOfWeek:    Wednesday
   Hour:         0
   Minute:       0
   Second:       0
   Milliseconds: 0

After adding 5 to each component of the DateTime:
   Era:          1
   Year:         2007
   Month:        10
   DayOfYear:    286
   DayOfMonth:   13
   DayOfWeek:    Saturday
   Hour:         5
   Minute:       5
   Second:       5
   Milliseconds: 5

*/

Imports System.Globalization


Public Class SamplesCalendar   

   Public Shared Sub Main()

      ' Sets a DateTime to April 3, 2002 of the Gregorian calendar.
      Dim myDT As New DateTime(2002, 4, 3, New GregorianCalendar())

      ' Uses the default calendar of the InvariantCulture.
      Dim myCal As Calendar = CultureInfo.InvariantCulture.Calendar

      ' Displays the values of the DateTime.
      Console.WriteLine("April 3, 2002 of the Gregorian calendar:")
      DisplayValues(myCal, myDT)

      ' Adds 5 to every component of the DateTime.
      myDT = myCal.AddYears(myDT, 5)
      myDT = myCal.AddMonths(myDT, 5)
      myDT = myCal.AddWeeks(myDT, 5)
      myDT = myCal.AddDays(myDT, 5)
      myDT = myCal.AddHours(myDT, 5)
      myDT = myCal.AddMinutes(myDT, 5)
      myDT = myCal.AddSeconds(myDT, 5)
      myDT = myCal.AddMilliseconds(myDT, 5)

      ' Displays the values of the DateTime.
      Console.WriteLine("After adding 5 to each component of the DateTime:")
      DisplayValues(myCal, myDT)

   End Sub

   Public Shared Sub DisplayValues(myCal As Calendar, myDT As DateTime)
      Console.WriteLine("   Era:          {0}", myCal.GetEra(myDT))
      Console.WriteLine("   Year:         {0}", myCal.GetYear(myDT))
      Console.WriteLine("   Month:        {0}", myCal.GetMonth(myDT))
      Console.WriteLine("   DayOfYear:    {0}", myCal.GetDayOfYear(myDT))
      Console.WriteLine("   DayOfMonth:   {0}", myCal.GetDayOfMonth(myDT))
      Console.WriteLine("   DayOfWeek:    {0}", myCal.GetDayOfWeek(myDT))
      Console.WriteLine("   Hour:         {0}", myCal.GetHour(myDT))
      Console.WriteLine("   Minute:       {0}", myCal.GetMinute(myDT))
      Console.WriteLine("   Second:       {0}", myCal.GetSecond(myDT))
      Console.WriteLine("   Milliseconds: {0}", myCal.GetMilliseconds(myDT))
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'April 3, 2002 of the Gregorian calendar:
'   Era:          1
'   Year:         2002
'   Month:        4
'   DayOfYear:    93
'   DayOfMonth:   3
'   DayOfWeek:    Wednesday
'   Hour:         0
'   Minute:       0
'   Second:       0
'   Milliseconds: 0
'
'After adding 5 to each component of the DateTime:
'   Era:          1
'   Year:         2007
'   Month:        10
'   DayOfYear:    286
'   DayOfMonth:   13
'   DayOfWeek:    Saturday
'   Hour:         5
'   Minute:       5
'   Second:       5
'   Milliseconds: 5

Açıklamalar

Takvim, zamanı hafta, ay ve yıl gibi birimlere böler. Bölmelerin sayısı, uzunluğu ve başlangıcı her takvimde farklılık gösterir.

Not

.NET'te takvim sınıflarını kullanma hakkında bilgi için bkz. Takvimlerle Çalışma.

Zaman içinde herhangi bir an, belirli bir takvim kullanılarak bir dizi sayısal değer olarak temsil edilebilir. Örneğin, Gregoryen takvimde (1999, 3, 20, 8, 46, 0, 0,0) yani 20 Mart 1999 C.E. saat 8:46:00:0.0'da bir vernal ekinoks oluştu. uygulamasıCalendar, belirli bir takvim aralığındaki herhangi bir tarihi benzer bir sayısal değer kümesiyle eşleyebilir ve DateTime ve DateTimeFormatInfoiçindeki bilgileri Calendar kullanarak bu tür sayısal değer kümelerini metinsel bir gösterimle eşleyebilir. Metinsel gösterim kültüre duyarlı olabilir; örneğin, EN-US kültürü için "08:46 Mart 1999 AD" veya ISO 8601 biçiminde "1999-03-20T08:46:00" gibi kültüre duyarsız olabilir.

Bir Calendar uygulama bir veya daha fazla dönemi tanımlayabilir. Calendar sınıfı, geçerli çağın (CurrentEra) 0 değerine sahip olduğu dönemleri numaralandırılmış tamsayılar olarak tanımlar.

Önemli

Japon takvimlerindeki dönemler imparatorun saltanatına dayanır ve bu nedenle değişmesi beklenir. Örneğin, 1 Mayıs 2019 ve JapaneseLunisolarCalendariçinde Reiwa döneminin başlangıcını işaretlediJapaneseCalendar. Bu tür bir çağ değişikliği, bu takvimleri kullanan tüm uygulamaları etkiler. Daha fazla bilgi edinmek ve uygulamalarınızın etkilenip etkilenmediğini belirlemek için bkz. .NET'te Japon takviminde yeni bir dönemi işleme. Uygulamalarınızı Windows sistemlerinde test ederek çağ değişikliğine hazır olmalarını sağlama hakkında bilgi için bkz. Uygulamanızı Japon dönemi değişikliğine hazırlama. .NET'te birden çok dönemi destekleyen takvimleri destekleyen özellikler ve birden çok dönemi destekleyen takvimlerle çalışırken en iyi yöntemler için bkz. Dönemlerle çalışma.

Takvim yılı ile dünyanın güneş etrafında döndürdiği gerçek saat veya ayın dünya etrafında döndürdiği gerçek saat arasındaki farkı telafi etmek için artık yılın standart takvim yılından farklı sayıda günü vardır. Her Calendar uygulama artık yılları farklı tanımlar.

Tutarlılık için her aralıktaki ilk üniteye (örneğin, ilk ay) 1 değeri atanır.

Ad System.Globalization alanı aşağıdaki Calendar uygulamaları içerir:

• ChineseLunisolarCalendar

• EastAsianLunisolarCalendar

• GregorianCalendar

• HebrewCalendar

• HijriCalendar

• JapaneseCalendar

• JapaneseLunisolarCalendar

• JulianCalendar

• KoreanCalendar

• KoreanLunisolarCalendar

• PersianCalendar

• TaiwanCalendar

• TaiwanLunisolarCalendar

• ThaiBuddhistCalendar

• UmAlQuraCalendar

Oluşturucular

Calendar()

Calendar sınıfının yeni bir örneğini başlatır.

Alanlar

CurrentEra

Geçerli takvimin geçerli dönemini temsil eder. Bu alanın değeri 0'dır.

Özellikler

AlgorithmType	Geçerli takvimin güneş tabanlı mı, ay tabanlı mı yoksa her ikisinin de birleşimi mi olduğunu belirten bir değer alır.
DaysInYearBeforeMinSupportedYear	Özelliği tarafından MinSupportedDateTime belirtilen yıldan önceki yıldaki gün sayısını alır.
Eras	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli takvimdeki dönemlerin listesini alır.
IsReadOnly	Bu Calendar nesnenin salt okunur olup olmadığını belirten bir değer alır.
MaxSupportedDateTime	Bu Calendar nesne tarafından desteklenen en son tarih ve saati alır.
MinSupportedDateTime	Bu Calendar nesne tarafından desteklenen en erken tarih ve saati alır.
TwoDigitYearMax	2 basamaklı bir yılla temsil edilebilen 100 yıllık aralığın son yılını alır veya ayarlar.

Yöntemler

AddDays(DateTime, Int32)	Belirtilen gün sayısından uzak DateTimeolan bir DateTime döndürür.
AddHours(DateTime, Int32)	Belirtilen saat sayısından uzak DateTimeolan bir DateTime döndürür.
AddMilliseconds(DateTime, Double)	Belirtilen sayıdan milisaniye uzakta DateTimeolan bir DateTime döndürür.
AddMinutes(DateTime, Int32)	DateTime Belirtilen sayıda dakika uzaklıkta DateTimebelirtilen değerini döndürür.
AddMonths(DateTime, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeöğesinden belirtilen sayıda ay uzakta olan bir DateTime döndürür.
AddSeconds(DateTime, Int32)	Belirtilen sayıdan saniye uzaklıkta olan DateTimebir DateTime döndürür.
AddWeeks(DateTime, Int32)	Belirtilen sayıdan belirtilen sayıda hafta uzakta DateTimeolan bir DateTime döndürür.
AddYears(DateTime, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeöğesinden belirtilen sayıda yıl uzakta olan bir DateTime döndürür.
Clone()	Geçerli Calendar nesnenin kopyası olan yeni bir nesne oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetDayOfMonth(DateTime)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeiçindeki ayın gününü döndürür.
GetDayOfWeek(DateTime)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeiçinde haftanın gününü döndürür.
GetDayOfYear(DateTime)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeiçinde yılın gününü döndürür.
GetDaysInMonth(Int32, Int32)	Geçerli dönemin belirtilen ayı ve yılındaki gün sayısını döndürür.
GetDaysInMonth(Int32, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ay, yıl ve dönemdeki gün sayısını döndürür.
GetDaysInYear(Int32)	Geçerli dönemin belirtilen yılındaki gün sayısını döndürür.
GetDaysInYear(Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen yıl ve dönemdeki gün sayısını döndürür.
GetEra(DateTime)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeöğesinin çağını döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetHour(DateTime)	Belirtilen DateTimeiçindeki saat değerini döndürür.
GetLeapMonth(Int32)	Belirtilen yıl için artık ayı hesaplar.
GetLeapMonth(Int32, Int32)	Belirtilen yıl ve dönem için artık ayı hesaplar.
GetMilliseconds(DateTime)	Belirtilen DateTimeiçindeki milisaniye değerini döndürür.
GetMinute(DateTime)	Belirtilen DateTimeiçindeki dakika değerini döndürür.
GetMonth(DateTime)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeiçindeki ayı döndürür.
GetMonthsInYear(Int32)	Geçerli dönemde belirtilen yıldaki ay sayısını döndürür.
GetMonthsInYear(Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dönemde belirtilen yıldaki ay sayısını döndürür.
GetSecond(DateTime)	Belirtilen DateTimeiçindeki saniye değerini döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Belirtilen DateTime değerdeki tarihi içeren yılın haftasını döndürür.
GetYear(DateTime)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeiçindeki yılı döndürür.
IsLeapDay(Int32, Int32, Int32)	Geçerli dönemde belirtilen tarihin artık gün olup olmadığını belirler.
IsLeapDay(Int32, Int32, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dönemde belirtilen tarihin artık gün olup olmadığını belirler.
IsLeapMonth(Int32, Int32)	Geçerli dönemde belirtilen yılda belirtilen ayın artık ay olup olmadığını belirler.
IsLeapMonth(Int32, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dönemde belirtilen yıl içinde belirtilen ayın artık ay olup olmadığını belirler.
IsLeapYear(Int32)	Geçerli dönemde belirtilen yılın artık yıl olup olmadığını belirler.
IsLeapYear(Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dönemde belirtilen yılın artık yıl olup olmadığını belirler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ReadOnly(Calendar)	Belirtilen Calendar nesnenin salt okunur bir sürümünü döndürür.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Geçerli dönemde belirtilen tarih ve saate ayarlanmış bir DateTime döndürür.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dönemde belirtilen tarih ve saate ayarlanmış bir DateTime döndürür.
ToFourDigitYear(Int32)	Uygun yüzyılı belirlemek için özelliğini kullanarak TwoDigitYearMax belirtilen yılı dört basamaklı bir yıla dönüştürür.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• DateTime
• DateTimeFormatInfo
• ChineseLunisolarCalendar
• EastAsianLunisolarCalendar
• GregorianCalendar
• HebrewCalendar
• HijriCalendar
• JapaneseCalendar
• JapaneseLunisolarCalendar
• JulianCalendar
• KoreanCalendar
• KoreanLunisolarCalendar
• PersianCalendar
• TaiwanCalendar
• TaiwanLunisolarCalendar
• ThaiBuddhistCalendar
• UmAlQuraCalendar
• Takvimlerle Çalışma