Calendar Sınıf

Tanım

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

public ref class Calendar abstract
public ref class Calendar abstract : ICloneable
public abstract class Calendar
public abstract class Calendar : ICloneable
[System.Serializable]
public abstract class Calendar
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Calendar : ICloneable
type Calendar = class
type Calendar = class
    interface ICloneable
[<System.Serializable>]
type Calendar = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Calendar = class
    interface ICloneable
Public MustInherit Class Calendar
Public MustInherit Class Calendar
Implements ICloneable
Devralma
Calendar
Türetilmiş
Öznitelikler
Uygulamalar

Ö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:

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)

Şunlara uygulanır

Ayrıca bkz.