Calendar Kelas

Referensi

Definisi

Ruang nama:: System.Globalization

Rakitan:: System.Globalization.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: Calendar.cs

Sumber:: Calendar.cs

Sumber:: Calendar.cs

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 waktu dalam pembagian, seperti minggu, bulan, dan tahun.

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

Warisan: Object
Calendar

Turunan: System.Globalization.EastAsianLunisolarCalendar

System.Globalization.GregorianCalendar

System.Globalization.HebrewCalendar

System.Globalization.HijriCalendar

System.Globalization.JapaneseCalendar

Lainnya…

Atribut: SerializableAttribute ComVisibleAttribute

Penerapan: ICloneable

Contoh

Contoh kode berikut menunjukkan anggota Calendar kelas .

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

Keterangan

Kalender membagi waktu menjadi satuan, seperti minggu, bulan, dan tahun. Jumlah, panjang, dan awal pembagian bervariasi di setiap kalender.

Catatan

Untuk informasi tentang menggunakan kelas kalender di .NET, lihat Bekerja dengan Kalender.

Setiap momen dalam waktu dapat direpresentasikan sebagai sekumpulan nilai numerik menggunakan kalender tertentu. Misalnya, equinox vernal terjadi pada (1999, 3, 20, 8, 46, 0, 0,0) di kalender Gregorian, yaitu, 20 Maret 1999 C.E. pada 8:46:00:0.0. Implementasi Calendar dapat memetakan tanggal apa pun dalam rentang kalender tertentu ke sekumpulan nilai numerik yang sama, dan DateTime dapat memetakan set nilai numerik tersebut ke representasi tekstual menggunakan informasi dari Calendar dan DateTimeFormatInfo. Representasi tekstual dapat peka terhadap budaya, misalnya, "8:46 AM 20 Maret 1999 AD" untuk budaya en-US, atau tidak peka budaya, misalnya, "1999-03-20T08:46:00" dalam format ISO 8601.

Implementasi Calendar dapat menentukan satu atau beberapa era. Kelas Calendar mengidentifikasi penghapusan sebagai bilangan bulat yang dijumlahkan, di mana era saat ini (CurrentEra) memiliki nilai 0.

Penting

Era di kalender Jepang didasarkan pada pemerintahan kaisar dan karenanya diharapkan berubah. Misalnya, 1 Mei 2019 menandai awal era Reiwa di JapaneseCalendar dan JapaneseLunisolarCalendar. Perubahan era seperti itu mempengaruhi semua aplikasi yang menggunakan kalender ini. Untuk informasi selengkapnya dan untuk menentukan apakah aplikasi Anda terpengaruh, lihat Menangani era baru di kalender Jepang di .NET. Untuk informasi tentang menguji aplikasi Anda pada sistem Windows untuk memastikan kesiapannya untuk perubahan era, lihat Menyiapkan aplikasi Anda untuk perubahan era Jepang. Untuk fitur di .NET yang mendukung kalender dengan beberapa era dan untuk praktik terbaik saat bekerja dengan kalender yang mendukung beberapa era, lihat Bekerja dengan era.

Untuk menebus perbedaan antara tahun kalender dan waktu aktual bumi berputar di sekitar matahari atau waktu aktual bahwa bulan berputar di sekitar bumi, tahun kampung memiliki jumlah hari yang berbeda dari tahun kalender standar. Setiap Calendar implementasi mendefinisikan tahun kampung secara berbeda.

Untuk konsistensi, unit pertama di setiap interval (bulan pertama, misalnya) diberi nilai 1.

Namespace System.Globalization layanan mencakup implementasi berikut Calendar :

Konstruktor

Calendar()

Menginisialisasi instans baru kelas Calendar.

Bidang

CurrentEra

Mewakili era kalender saat ini. Nilai bidang ini adalah 0.

Properti

AlgorithmType	Mendapatkan nilai yang menunjukkan apakah kalender saat ini berbasis surya, berbasis bulan, atau kombinasi keduanya.
DaysInYearBeforeMinSupportedYear	Mendapatkan jumlah hari dalam tahun yang mendahului tahun yang ditentukan oleh MinSupportedDateTime properti .
Eras	Saat ditimpa di kelas turunan, mendapatkan daftar era di kalender saat ini.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah objek ini Calendar baca-saja.
MaxSupportedDateTime	Mendapatkan tanggal dan waktu terbaru yang didukung oleh objek ini Calendar .
MinSupportedDateTime	Mendapatkan tanggal dan waktu paling awal yang didukung oleh objek ini Calendar .
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.
AddHours(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah jam yang ditentukan jauh dari yang ditentukan DateTime.
AddMilliseconds(DateTime, Double)	Mengembalikan DateTime yang merupakan jumlah milidetik yang ditentukan jauh dari yang ditentukan DateTime.
AddMinutes(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah menit yang ditentukan jauh dari yang ditentukan DateTime.
AddMonths(DateTime, Int32)	Ketika ditimpa dalam kelas turunan DateTime , mengembalikan yang merupakan jumlah bulan yang ditentukan jauh dari yang ditentukan DateTime.
AddSeconds(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah detik yang ditentukan jauh dari yang ditentukan DateTime.
AddWeeks(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah minggu yang ditentukan jauh dari yang ditentukan DateTime.
AddYears(DateTime, Int32)	Ketika ditimpa dalam kelas turunan, mengembalikan DateTime yang merupakan jumlah tahun yang ditentukan jauh dari yang ditentukan DateTime.
Clone()	Membuat objek baru yang merupakan salinan objek saat ini Calendar .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDayOfMonth(DateTime)	Ketika ditimpa di kelas turunan, mengembalikan hari dalam sebulan dalam yang ditentukan DateTime.
GetDayOfWeek(DateTime)	Ketika ditimpa di kelas turunan, mengembalikan hari dalam seminggu dalam yang ditentukan DateTime.
GetDayOfYear(DateTime)	Ketika ditimpa dalam kelas turunan, mengembalikan hari dalam setahun dalam yang ditentukan DateTime.
GetDaysInMonth(Int32, Int32)	Mengembalikan jumlah hari dalam bulan dan tahun yang ditentukan dari era saat ini.
GetDaysInMonth(Int32, Int32, Int32)	Saat ditimpa dalam kelas turunan, mengembalikan jumlah hari dalam bulan, tahun, dan era yang ditentukan.
GetDaysInYear(Int32)	Mengembalikan jumlah hari dalam tahun yang ditentukan dari era saat ini.
GetDaysInYear(Int32, Int32)	Saat ditimpa dalam kelas turunan, mengembalikan jumlah hari dalam tahun dan era yang ditentukan.
GetEra(DateTime)	Ketika ditimpa di kelas turunan, mengembalikan era dari yang ditentukan DateTime.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHour(DateTime)	Mengembalikan nilai jam dalam yang ditentukan DateTime.
GetLeapMonth(Int32)	Menghitung bulan kampung untuk tahun tertentu.
GetLeapMonth(Int32, Int32)	Menghitung bulan kampung untuk tahun dan era tertentu.
GetMilliseconds(DateTime)	Mengembalikan nilai milidetik dalam yang ditentukan DateTime.
GetMinute(DateTime)	Mengembalikan nilai menit dalam yang ditentukan DateTime.
GetMonth(DateTime)	Saat ditimpa dalam kelas turunan, mengembalikan bulan dalam yang ditentukan DateTime.
GetMonthsInYear(Int32)	Mengembalikan jumlah bulan dalam tahun yang ditentukan di era saat ini.
GetMonthsInYear(Int32, Int32)	Ketika ditimpa dalam kelas turunan, mengembalikan jumlah bulan dalam tahun yang ditentukan di era yang ditentukan.
GetSecond(DateTime)	Mengembalikan nilai detik dalam yang ditentukan DateTime.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek)	Mengembalikan minggu dalam setahun yang menyertakan tanggal dalam nilai yang ditentukan DateTime .
GetYear(DateTime)	Ketika ditimpa dalam kelas turunan, mengembalikan tahun dalam yang ditentukan DateTime.
IsLeapDay(Int32, Int32, Int32)	Menentukan apakah tanggal yang ditentukan di era saat ini adalah hari lompatan.
IsLeapDay(Int32, Int32, Int32, Int32)	Ketika ditimpa di kelas turunan, menentukan apakah tanggal yang ditentukan dalam era yang ditentukan adalah hari kabisat.
IsLeapMonth(Int32, Int32)	Menentukan apakah bulan yang ditentukan pada tahun yang ditentukan di era saat ini adalah bulan kampung.
IsLeapMonth(Int32, Int32, Int32)	Ketika ditimpa dalam kelas turunan, menentukan apakah bulan yang ditentukan pada tahun yang ditentukan di era yang ditentukan adalah bulan kabisat.
IsLeapYear(Int32)	Menentukan apakah tahun yang ditentukan di era saat ini adalah tahun kampung.
IsLeapYear(Int32, Int32)	Ketika ditimpa dalam kelas turunan, menentukan apakah tahun yang ditentukan di era yang ditentukan adalah tahun kabisat.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ReadOnly(Calendar)	Mengembalikan versi baca-saja dari objek yang ditentukan Calendar .
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Mengembalikan DateTime yang diatur ke tanggal dan waktu yang ditentukan di era saat ini.
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Saat ditimpa dalam kelas turunan DateTime , mengembalikan 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)

Berlaku untuk