Calendar Sınıf

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kodlar:

netstandard.dll, 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 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 ayırır. Bölmelerin sayısı, uzunluğu ve başlangıcı her takvimde farklılık gösterir.

Note

.NET 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 sayısal değerler kümesi olarak gösterilebilir. Örneğin, Gregoryen takvimde (1999, 3, 20, 8, 46, 0, 0,0) yani 20 Mart 1999 C.E.'de 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 Calendariçindeki bilgileri DateTimeFormatInfo 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önem 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.

Important

Japon takvimlerindeki dönemler imparatorun saltanatına dayanır ve bu nedenle değişmesi beklenir. Örneğin, 1 Mayıs 2019, JapaneseCalendar ve JapaneseLunisolarCalendarReiwa döneminin başlangıcını işaretledi. Bu tür bir dönem 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. .NETJapon takviminde yeni bir çağı işleme. Zaman değişikliğine hazır olduğundan emin olmak için uygulamalarınızı Windows sistemlerinde test etme hakkında bilgi için bkz. Uygulamanızı Japon çağı değişikliğine hazırlama. .NET'te birden çok çağa sahip takvimleri destekleyen özellikler ve birden çok çağı 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 zaman 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

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

Alanlar

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

Özellikler

Name	Description
AlgorithmType	Geçerli takvimin güneş tabanlı mı, ay tabanlı mı yoksa ikisinin 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	100 yıllık aralığın 2 basamaklı bir yılla temsil edilebilen son yılını alır veya ayarlar.

Yöntemler

Name	Description
AddDays(DateTime, Int32)	Belirtilen gün sayısından uzak DateTimeolan bir DateTime döndürür.
AddHours(DateTime, Int32)	DateTime Belirtilen sayıda saat uzaklıkta belirtilen bir DateTimedöndürür.
AddMilliseconds(DateTime, Double)	Belirtilen sayıda 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 DateTimesayıda ay uzakta olan bir DateTime döndürür.
AddSeconds(DateTime, Int32)	DateTime Belirtilen sayıda saniye uzaklıkta DateTimebelirtilen bir döndürür.
AddWeeks(DateTime, Int32)	DateTime Belirtilen sayıda hafta uzaklıkta DateTimebelirtilen bir döndürür.
AddYears(DateTime, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen DateTimeyıl sayısından uzak 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, 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.
GetDaysInMonth(Int32, Int32)	Geçerli dönemin belirtilen ay ve 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.
GetDaysInYear(Int32)	Geçerli dönemin belirtilen yılındaki 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, Int32)	Belirtilen yıl ve dönem için artık ayı hesaplar.
GetLeapMonth(Int32)	Belirtilen yıl 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, 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.
GetMonthsInYear(Int32)	Geçerli 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()	Geçerli örneğin Type 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, 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.
IsLeapDay(Int32, Int32, Int32)	Geçerli dönemde belirtilen tarihin artık gün 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ılda belirtilen ayın artık ay olup olmadığını belirler.
IsLeapMonth(Int32, Int32)	Geçerli dönemde belirtilen yılda belirtilen ayın artık ay 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.
IsLeapYear(Int32)	Geçerli dönemde belirtilen yılın artık yıl olup olmadığını belirler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ReadOnly(Calendar)	Belirtilen Calendar nesnenin salt okunur sürümünü 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.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Geçerli 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 bir dize 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