GregorianCalendar Kelas

Definisi

Ruang nama:

System.Globalization

Rakitan:

System.Runtime.dll

Sumber:

GregorianCalendar.cs

Mewakili kalender Gregorian.

public ref class GregorianCalendar : System::Globalization::Calendar

public class GregorianCalendar : System.Globalization.Calendar

type GregorianCalendar = class
    inherit Calendar

Public Class GregorianCalendar
Inherits Calendar

Warisan

Object

Calendar

GregorianCalendar

Contoh

Contoh kode berikut menunjukkan bahwa DateTimeFormatInfo mengabaikan tanda baca dalam nama era, hanya jika kalender adalah Gregorian dan budaya menggunakan nama era "A.D.".

using namespace System;
using namespace System::Globalization;
using namespace System::Collections;
int main()
{
   
   // Creates strings with punctuation and without.
   String^ strADPunc = "A.D.";
   String^ strADNoPunc = "AD";
   String^ strCEPunc = "C.E.";
   String^ strCENoPunc = "CE";
   
   // Calls DTFI::GetEra for each culture that uses GregorianCalendar as the default calendar.
   Console::WriteLine( "            ----- AD -----  ----- CE -----" );
   Console::WriteLine( "CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR" );
   IEnumerator^ en = CultureInfo::GetCultures( CultureTypes::SpecificCultures )->GetEnumerator();
   while ( en->MoveNext() )
   {
      CultureInfo^ myCI = safe_cast<CultureInfo^>(en->Current);
      Console::Write( "{0, -12}", myCI );
      Console::Write( "{0,-7}{1,-9}", myCI->DateTimeFormat->GetEra( strADPunc ), myCI->DateTimeFormat->GetEra( strADNoPunc ) );
      Console::Write( "{0, -7}{1, -9}", myCI->DateTimeFormat->GetEra( strCEPunc ), myCI->DateTimeFormat->GetEra( strCENoPunc ) );
      Console::Write( "{0}", myCI->Calendar );
      Console::WriteLine();
   }
}

/*
This code produces the following output.  This output has been cropped for brevity.

            ----- AD -----  ----- CE -----
CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR
ar-SA       -1     -1       -1     -1       System.Globalization.HijriCalendar
ar-IQ       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-EG       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-LY       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-DZ       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-MA       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-TN       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-OM       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-YE       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-SY       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-JO       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-LB       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-KW       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-AE       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-BH       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-QA       1      1        -1     -1       System.Globalization.GregorianCalendar
bg-BG       1      1        -1     -1       System.Globalization.GregorianCalendar
ca-ES       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-TW       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-CN       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-HK       1      1        -1     -1       System.Globalization.GregorianCalendar
zh-SG       1      1        -1     -1       System.Globalization.GregorianCalendar
zh-MO       1      1        -1     -1       System.Globalization.GregorianCalendar
cs-CZ       -1     -1       -1     -1       System.Globalization.GregorianCalendar
da-DK       1      1        -1     -1       System.Globalization.GregorianCalendar

*/

using System;
using System.Globalization;

public class SamplesGregorianCalendar  {

   public static void Main()  {

      // Creates strings with punctuation and without.
      String strADPunc = "A.D.";
      String strADNoPunc = "AD";
      String strCEPunc = "C.E.";
      String strCENoPunc = "CE";

      // Calls DTFI.GetEra for each culture that uses GregorianCalendar as the default calendar.
      Console.WriteLine( "            ----- AD -----  ----- CE -----" );
      Console.WriteLine( "CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR" );
      foreach ( CultureInfo myCI in CultureInfo.GetCultures( CultureTypes.SpecificCultures ) )  {
         Console.Write( "{0,-12}", myCI );
         Console.Write( "{0,-7}{1,-9}", myCI.DateTimeFormat.GetEra( strADPunc ), myCI.DateTimeFormat.GetEra( strADNoPunc ) );
         Console.Write( "{0,-7}{1,-9}", myCI.DateTimeFormat.GetEra( strCEPunc ), myCI.DateTimeFormat.GetEra( strCENoPunc ) );
         Console.Write( "{0}", myCI.Calendar );
         Console.WriteLine();
      }
   }
}

/*
This code produces the following output.  This output has been cropped for brevity.

            ----- AD -----  ----- CE -----
CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR
ar-SA       -1     -1       -1     -1       System.Globalization.HijriCalendar
ar-IQ       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-EG       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-LY       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-DZ       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-MA       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-TN       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-OM       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-YE       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-SY       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-JO       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-LB       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-KW       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-AE       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-BH       1      1        -1     -1       System.Globalization.GregorianCalendar
ar-QA       1      1        -1     -1       System.Globalization.GregorianCalendar
bg-BG       1      1        -1     -1       System.Globalization.GregorianCalendar
ca-ES       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-TW       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-CN       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-HK       -1     -1       -1     -1       System.Globalization.GregorianCalendar
zh-SG       1      1        -1     -1       System.Globalization.GregorianCalendar
zh-MO       1      1        -1     -1       System.Globalization.GregorianCalendar
cs-CZ       -1     -1       -1     -1       System.Globalization.GregorianCalendar
da-DK       1      1        -1     -1       System.Globalization.GregorianCalendar

*/

Imports System.Globalization

Public Class SamplesGregorianCalendar

   Public Shared Sub Main()

      ' Creates strings with punctuation and without.
      Dim strADPunc As [String] = "A.D."
      Dim strADNoPunc As [String] = "AD"
      Dim strCEPunc As [String] = "C.E."
      Dim strCENoPunc As [String] = "CE"

      ' Calls DTFI.GetEra for each culture that uses GregorianCalendar as the default calendar.
      Console.WriteLine("            ----- AD -----  ----- CE -----")
      Console.WriteLine("CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR")
      Dim myCI As CultureInfo
      For Each myCI In  CultureInfo.GetCultures(CultureTypes.SpecificCultures)
         Console.Write("{0,-12}", myCI)
         Console.Write("{0,-7}{1,-9}", myCI.DateTimeFormat.GetEra(strADPunc), myCI.DateTimeFormat.GetEra(strADNoPunc))
         Console.Write("{0,-7}{1,-9}", myCI.DateTimeFormat.GetEra(strCEPunc), myCI.DateTimeFormat.GetEra(strCENoPunc))
         Console.Write("{0}", myCI.Calendar)
         Console.WriteLine()
      Next myCI

   End Sub

End Class


'This code produces the following output.  This output has been cropped for brevity.
'
'            ----- AD -----  ----- CE -----
'CULTURE     PUNC   NO PUNC  PUNC   NO PUNC  CALENDAR
'ar-SA       -1     -1       -1     -1       System.Globalization.HijriCalendar
'ar-IQ       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-EG       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-LY       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-DZ       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-MA       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-TN       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-OM       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-YE       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-SY       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-JO       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-LB       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-KW       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-AE       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-BH       1      1        -1     -1       System.Globalization.GregorianCalendar
'ar-QA       1      1        -1     -1       System.Globalization.GregorianCalendar
'bg-BG       1      1        -1     -1       System.Globalization.GregorianCalendar
'ca-ES       -1     -1       -1     -1       System.Globalization.GregorianCalendar
'zh-TW       -1     -1       -1     -1       System.Globalization.GregorianCalendar
'zh-CN       -1     -1       -1     -1       System.Globalization.GregorianCalendar
'zh-HK       -1     -1       -1     -1       System.Globalization.GregorianCalendar
'zh-SG       1      1        -1     -1       System.Globalization.GregorianCalendar
'zh-MO       1      1        -1     -1       System.Globalization.GregorianCalendar
'cs-CZ       -1     -1       -1     -1       System.Globalization.GregorianCalendar
'da-DK       1      1        -1     -1       System.Globalization.GregorianCalendar

Keterangan

Kalender Gregorian mengenali dua era: B.C. atau B.C.E., dan A.D. atau C.E. Implementasi GregorianCalendar kelas ini hanya mengenali era saat ini (A.D. atau C.E.).

Catatan

Untuk informasi tentang menggunakan GregorianCalendar kelas dan kelas kalender lainnya di .NET Framework, lihat Bekerja dengan Kalender.

Tahun kabut dalam kalender Gregorian didefinisikan sebagai tahun yang dapat dibagi secara merata oleh 4, kecuali jika dibagi dengan 100. Namun, tahun-tahun yang dibagi oleh 400 adalah tahun kampung. Misalnya, tahun 1900 bukan tahun kampung, tetapi tahun 2000. Tahun umum memiliki 365 hari dan tahun kampung memiliki 366 hari.

Kalender Gregorian memiliki 12 bulan dengan masing-masing 28 hingga 31 hari: Januari (31 hari), Februari (28 atau 29 hari), Maret (31 hari), April (30 hari), Mei (30 hari), Mei (31 hari), Juni (30 hari), Juli (31 hari), Agustus (31 hari), September (30 hari), Oktober (31 hari), November (30 hari), dan Desember (31 hari). Februari memiliki 29 hari selama tahun kampung dan 28 selama tahun-tahun umum.

Penting

Secara default, semua DateTime dan DateTimeOffset nilai mengekspresikan tanggal dan waktu di kalender Gregorian.

Kalender Gregorian dikembangkan sebagai pengganti kalender Julian (yang diwakili oleh JulianCalendar kelas) dan pertama kali diperkenalkan dalam sejumlah kecil budaya pada 15 Oktober 1582. Saat bekerja dengan tanggal bersejarah yang mendahului adopsi budaya kalender Gregorian, Anda harus menggunakan kalender asli jika tersedia di .NET Framework. Misalnya, Denmark berubah dari kalender Julian ke kalender Gregorian pada 19 Februari (dalam kalender Julian) atau 1 Maret (di kalender Gregorian) 1700. Dalam hal ini, untuk tanggal sebelum adopsi kalender Gregorian, Anda harus menggunakan kalender Julian. Namun, perhatikan bahwa tidak ada budaya yang menawarkan dukungan intrinsik untuk kelas.JulianCalendar Anda harus menggunakan JulianCalendar kelas sebagai kalender mandiri. Untuk informasi selengkapnya, lihat Menggunakan Objek.

Contoh berikut menggambarkan bahwa 18 Februari 1700 di kalender Julian, yang merupakan hari terakhir kalender Julian secara resmi digunakan di Denmark, adalah satu hari lebih awal dari 1 Maret 1700 di kalender Gregorian.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      Thread.CurrentThread.CurrentCulture = new CultureInfo("da-DK");

      JulianCalendar jc = new JulianCalendar();
      DateTime lastDate = new DateTime(1700, 2, 18, jc);
      Console.WriteLine("Last date (Gregorian): {0:d}", lastDate);
      Console.WriteLine("Last date (Julian): {0}-{1}-{2}\n", jc.GetDayOfMonth(lastDate),
                        jc.GetMonth(lastDate), jc.GetYear(lastDate));

      DateTime firstDate = lastDate.AddDays(1);
      Console.WriteLine("First date (Gregorian): {0:d}", firstDate);
      Console.WriteLine("First date (Julian): {0}-{1}-{2}",  jc.GetDayOfMonth(firstDate),
                        jc.GetMonth(firstDate), jc.GetYear(firstDate));
   }
}
// The example displays the following output:
//       Last date (Gregorian): 28-02-1700
//       Last date (Julian): 18-2-1700
//
//       First date (Gregorian): 01-03-1700
//       First date (Julian): 19-2-1700

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      Thread.CurrentThread.CurrentCulture = New CultureInfo("da-DK")
      
      Dim jc As New JulianCalendar()
      Dim lastDate As New DateTime(1700, 2, 18, jc)
      Console.WriteLine("Last date (Gregorian): {0:d}", lastDate)
      Console.WriteLine("Last date (Julian): {0}-{1}-{2}", jc.GetDayOfMonth(lastDate),
                        jc.GetMonth(lastDate), jc.GetYear(lastDate))
      Console.WriteLine()
      
      Dim firstDate As DateTime = lastDate.AddDays(1)
      Console.WriteLine("First date (Gregorian): {0:d}", firstDate)
      Console.WriteLine("First date (Julian): {0}-{1}-{2}",  jc.GetDayOfMonth(firstDate),
                        jc.GetMonth(firstDate), jc.GetYear(firstDate))
   End Sub
End Module
' The example displays the following output:
'       Last date (Gregorian): 28-02-1700
'       Last date (Julian): 18-2-1700
'       
'       First date (Gregorian): 01-03-1700
'       First date (Julian): 19-2-1700

Masing-masing CultureInfo mendukung sekumpulan kalender. Properti Calendar mengembalikan kalender default untuk budaya, dan OptionalCalendars properti mengembalikan array yang berisi semua kalender yang didukung oleh budaya. Untuk mengubah kalender yang CultureInfodigunakan oleh , aplikasi dapat mengatur properti ke Calendar yang baru Calendar.

GetEra mengabaikan tanda baca dalam nama era yang disingkat, hanya jika GregorianCalendar dipilih DateTimeFormatInfo.Calendar dan budaya menggunakan "A.D." sebagai nama era, yaitu, "A.D." setara dengan "AD".

Konstruktor

GregorianCalendar()	Menginisialisasi instans GregorianCalendar baru kelas menggunakan nilai default GregorianCalendarTypes .
GregorianCalendar(GregorianCalendarTypes)	Menginisialisasi instans GregorianCalendar baru kelas menggunakan nilai yang ditentukan GregorianCalendarTypes .

Bidang

ADEra	Mewakili era saat ini. Bidang ini konstan.
CurrentEra	Mewakili era kalender saat ini. Nilai bidang ini adalah 0. (Diperoleh dari Calendar)

Properti

AlgorithmType	Mendapatkan nilai yang menunjukkan apakah kalender saat ini berbasis surya, berbasis bulan, atau kombinasi keduanya.
CalendarType	Mendapatkan atau mengatur GregorianCalendarTypes nilai yang menunjukkan versi bahasa dari versi saat ini GregorianCalendar.
DaysInYearBeforeMinSupportedYear	Mendapatkan jumlah hari dalam tahun yang mendahului tahun yang ditentukan oleh MinSupportedDateTime properti . (Diperoleh dari Calendar)
Eras	Mendapatkan daftar era di GregorianCalendar.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah objek ini Calendar bersifat baca-saja. (Diperoleh dari Calendar)
MaxSupportedDateTime	Mendapatkan tanggal dan waktu terbaru yang didukung oleh jenis .GregorianCalendar
MinSupportedDateTime	Mendapatkan tanggal dan waktu paling awal yang didukung oleh jenis .GregorianCalendar
TwoDigitYearMax	Mendapatkan atau menetapkan tahun terakhir dari rentang 100 tahun yang dapat diwakili oleh tahun 2 digit.

Metode

AddDays(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah hari yang ditentukan jauh dari yang ditentukan DateTime. (Diperoleh dari Calendar)
AddHours(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah jam yang ditentukan dari yang ditentukan DateTime. (Diperoleh dari Calendar)
AddMilliseconds(DateTime, Double)	Mengembalikan DateTime yang merupakan jumlah milidetik yang ditentukan dari yang ditentukan DateTime. (Diperoleh dari Calendar)
AddMinutes(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah menit yang ditentukan dari yang ditentukan DateTime. (Diperoleh dari Calendar)
AddMonths(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah bulan yang ditentukan jauh dari yang ditentukan DateTime.
AddSeconds(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah detik yang ditentukan dari yang ditentukan DateTime. (Diperoleh dari Calendar)
AddWeeks(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah minggu yang ditentukan dari yang ditentukan DateTime. (Diperoleh dari Calendar)
AddYears(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah tahun yang ditentukan dari yang ditentukan DateTime.
Clone()	Membuat objek baru yang merupakan salinan objek saat ini Calendar . (Diperoleh dari Calendar)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDayOfMonth(DateTime)	Mengembalikan hari dalam sebulan dalam yang ditentukan DateTime.
GetDayOfWeek(DateTime)	Mengembalikan hari dalam seminggu dalam yang ditentukan DateTime.
GetDayOfYear(DateTime)	Mengembalikan hari dalam setahun dalam yang ditentukan DateTime.
GetDaysInMonth(Int32, Int32)	Mengembalikan jumlah hari dalam bulan dan tahun yang ditentukan dari era saat ini. (Diperoleh dari Calendar)
GetDaysInMonth(Int32, Int32, Int32)	Mengembalikan jumlah hari dalam bulan yang ditentukan dalam tahun yang ditentukan di era yang ditentukan.
GetDaysInYear(Int32)	Mengembalikan jumlah hari dalam tahun yang ditentukan dari era saat ini. (Diperoleh dari Calendar)
GetDaysInYear(Int32, Int32)	Mengembalikan jumlah hari dalam tahun yang ditentukan di era yang ditentukan.
GetEra(DateTime)	Mengembalikan era dalam DateTime.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHour(DateTime)	Mengembalikan nilai jam dalam yang ditentukan DateTime. (Diperoleh dari Calendar)
GetLeapMonth(Int32)	Menghitung bulan kampung untuk tahun tertentu. (Diperoleh dari Calendar)
GetLeapMonth(Int32, Int32)	Menghitung bulan kampung untuk tahun dan era tertentu.
GetMilliseconds(DateTime)	Mengembalikan nilai milidetik dalam yang ditentukan DateTime. (Diperoleh dari Calendar)
GetMinute(DateTime)	Mengembalikan nilai menit dalam yang ditentukan DateTime. (Diperoleh dari Calendar)
GetMonth(DateTime)	Mengembalikan bulan dalam yang ditentukan DateTime.
GetMonthsInYear(Int32)	Mengembalikan jumlah bulan dalam tahun yang ditentukan di era saat ini. (Diperoleh dari Calendar)
GetMonthsInYear(Int32, Int32)	Mengembalikan jumlah bulan dalam tahun yang ditentukan di era yang ditentukan.
GetSecond(DateTime)	Mengembalikan nilai detik dalam yang ditentukan DateTime. (Diperoleh dari Calendar)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Mengembalikan minggu dalam setahun yang menyertakan tanggal dalam nilai yang ditentukan DateTime . (Diperoleh dari Calendar)
GetYear(DateTime)	Mengembalikan tahun dalam yang ditentukan DateTime.
IsLeapDay(Int32, Int32, Int32)	Menentukan apakah tanggal yang ditentukan di era saat ini adalah hari lompatan. (Diperoleh dari Calendar)
IsLeapDay(Int32, Int32, Int32, Int32)	Menentukan apakah tanggal yang ditentukan dalam era yang ditentukan adalah hari lompatan.
IsLeapMonth(Int32, Int32)	Menentukan apakah bulan yang ditentukan pada tahun yang ditentukan di era saat ini adalah bulan kampung. (Diperoleh dari Calendar)
IsLeapMonth(Int32, Int32, Int32)	Menentukan apakah bulan yang ditentukan dalam tahun yang ditentukan di era yang ditentukan adalah bulan kampung.
IsLeapYear(Int32)	Menentukan apakah tahun yang ditentukan di era saat ini adalah tahun kampung. (Diperoleh dari Calendar)
IsLeapYear(Int32, Int32)	Menentukan apakah tahun yang ditentukan dalam era yang ditentukan adalah tahun kampung.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Mengembalikan DateTime yang diatur ke tanggal dan waktu yang ditentukan di era saat ini. (Diperoleh dari Calendar)
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Mengembalikan DateTime yang diatur ke tanggal dan waktu yang ditentukan di era yang ditentukan.
ToFourDigitYear(Int32)	Mengonversi tahun yang ditentukan menjadi tahun empat digit dengan menggunakan TwoDigitYearMax properti untuk menentukan abad yang sesuai.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Calendar
• Calendar
• OptionalCalendars
• Bekerja dengan Kalender