GregorianCalendar Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili kalender Gregorian.
public ref class GregorianCalendar : System::Globalization::Calendarpublic class GregorianCalendar : System.Globalization.Calendar[System.Serializable]
public class GregorianCalendar : System.Globalization.Calendar[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class GregorianCalendar : System.Globalization.Calendartype GregorianCalendar = class
inherit Calendar[<System.Serializable>]
type GregorianCalendar = class
inherit Calendar[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GregorianCalendar = class
inherit CalendarPublic Class GregorianCalendar
Inherits Calendar- Warisan
- Atribut
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 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.).
Nota
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 dibagi 100. Namun, tahun-tahun yang dapat dibagi dengan 400 adalah tahun kabisat. Misalnya, tahun 1900 bukan tahun kampung, tetapi tahun 2000 itu. 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 (28 atau 29 hari), Maret (31 hari), April (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 nilai dan DateTimeOffset mengekspresikan tanggal dan waktu dalam 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 dalam .NET Framework. Misalnya, Denmark berubah dari kalender Julian ke kalender Gregorian pada 19 Februari (dalam kalender Julian) atau 1 Maret (dalam 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 dalam 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 Calendar properti ke baru Calendar.
GetEra mengabaikan tanda baca dalam nama era yang disingkat, hanya jika GregorianCalendar dipilih dan DateTimeFormatInfo.Calendar budaya menggunakan "A.D." sebagai nama era, yaitu, "A.D." setara dengan "AD".
Konstruktor
| Nama | Deskripsi |
|---|---|
| GregorianCalendar() |
Menginisialisasi instans GregorianCalendar baru kelas menggunakan nilai default GregorianCalendarTypes . |
| GregorianCalendar(GregorianCalendarTypes) |
Menginisialisasi instans GregorianCalendar baru kelas menggunakan nilai yang ditentukan GregorianCalendarTypes . |
Bidang
| Nama | Deskripsi |
|---|---|
| ADEra |
Mewakili era saat ini. Bidang ini konstan. |
| CurrentEra |
Mewakili era kalender saat ini. Nilai bidang ini adalah 0. (Diperoleh dari Calendar) |
Properti
| Nama | Deskripsi |
|---|---|
| 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 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
| Nama | Deskripsi |
|---|---|
| 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 jauh dari yang ditentukan DateTime. (Diperoleh dari Calendar) |
| AddMilliseconds(DateTime, Double) |
Mengembalikan DateTime yang merupakan jumlah milidetik yang ditentukan jauh dari yang ditentukan DateTime. (Diperoleh dari Calendar) |
| AddMinutes(DateTime, Int32) |
Mengembalikan DateTime yang merupakan jumlah menit yang ditentukan jauh 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 jauh dari yang ditentukan |
| AddWeeks(DateTime, Int32) |
Mengembalikan DateTime yang merupakan jumlah minggu yang ditentukan jauh dari yang ditentukan DateTime. (Diperoleh dari Calendar) |
| AddYears(DateTime, Int32) |
Mengembalikan DateTime yang merupakan jumlah tahun yang ditentukan jauh 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 .DateTime |
| GetDayOfWeek(DateTime) |
Mengembalikan hari dalam seminggu dalam .DateTime |
| GetDayOfYear(DateTime) |
Mengembalikan hari dalam setahun dalam .DateTime |
| GetDaysInMonth(Int32, Int32, Int32) |
Mengembalikan jumlah hari dalam bulan yang ditentukan dalam tahun yang ditentukan di era yang ditentukan. |
| GetDaysInMonth(Int32, Int32) |
Mengembalikan jumlah hari dalam bulan dan tahun yang ditentukan dari era saat ini. (Diperoleh dari Calendar) |
| GetDaysInYear(Int32, Int32) |
Mengembalikan jumlah hari dalam tahun yang ditentukan di era yang ditentukan. |
| GetDaysInYear(Int32) |
Mengembalikan jumlah hari dalam tahun yang ditentukan dari era saat ini. (Diperoleh dari Calendar) |
| GetEra(DateTime) |
Mengembalikan era dalam DateTime. |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetHour(DateTime) |
Mengembalikan nilai jam dalam DateTime. (Diperoleh dari Calendar) |
| GetLeapMonth(Int32, Int32) |
Menghitung bulan lompatan untuk tahun dan era tertentu. |
| GetLeapMonth(Int32) |
Menghitung bulan lompatan untuk tahun tertentu. (Diperoleh dari Calendar) |
| GetMilliseconds(DateTime) |
Mengembalikan nilai milidetik dalam DateTime. (Diperoleh dari Calendar) |
| GetMinute(DateTime) |
Mengembalikan nilai menit dalam DateTime. (Diperoleh dari Calendar) |
| GetMonth(DateTime) |
Mengembalikan bulan dalam .DateTime |
| GetMonthsInYear(Int32, Int32) |
Mengembalikan jumlah bulan dalam tahun yang ditentukan di era yang ditentukan. |
| GetMonthsInYear(Int32) |
Mengembalikan jumlah bulan dalam tahun yang ditentukan di era saat ini. (Diperoleh dari Calendar) |
| GetSecond(DateTime) |
Mengembalikan nilai detik dalam DateTime. (Diperoleh dari Calendar) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Mengembalikan minggu dalam setahun yang menyertakan tanggal dalam objek yang ditentukan DateTime . |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Mengembalikan minggu dalam setahun yang menyertakan tanggal dalam nilai yang ditentukan DateTime . (Diperoleh dari Calendar) |
| GetYear(DateTime) |
Mengembalikan tahun dalam DateTime. |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Menentukan apakah tanggal yang ditentukan dalam era yang ditentukan adalah hari lompatan. |
| IsLeapDay(Int32, Int32, Int32) |
Menentukan apakah tanggal yang ditentukan di era saat ini adalah hari kampung. (Diperoleh dari Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Menentukan apakah bulan yang ditentukan pada tahun yang ditentukan di era yang ditentukan adalah bulan kampung. |
| IsLeapMonth(Int32, Int32) |
Menentukan apakah bulan yang ditentukan pada tahun yang ditentukan di era saat ini adalah bulan kampung. (Diperoleh dari Calendar) |
| IsLeapYear(Int32, Int32) |
Menentukan apakah tahun yang ditentukan dalam era yang ditentukan adalah tahun kampung. |
| IsLeapYear(Int32) |
Menentukan apakah tahun yang ditentukan pada era saat ini adalah tahun kampung. (Diperoleh dari Calendar) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Mengembalikan DateTime yang diatur ke tanggal dan waktu yang ditentukan di era yang ditentukan. |
| 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) |
| 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) |
