Calendar Kelas

Definisi

Ruang nama:

System.Globalization

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

Calendar.cs

Mewakili waktu dalam pembagian, seperti minggu, bulan, dan tahun.

public ref class Calendar abstract : ICloneable

public abstract class Calendar : ICloneable

type Calendar = class
    interface ICloneable

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

System.Globalization.JulianCalendar

System.Globalization.KoreanCalendar

System.Globalization.PersianCalendar

System.Globalization.TaiwanCalendar

System.Globalization.ThaiBuddhistCalendar

System.Globalization.UmAlQuraCalendar

Penerapan

ICloneable

Contoh

Contoh kode berikut menunjukkan anggota Calendar kelas.

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.

Note

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

Setiap saat 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 pukul 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, "08:46 20 Maret 1999 Ad" untuk budaya en-US, atau tidak peka terhadap budaya, misalnya, "1999-03-20T08:46:00" dalam format ISO 8601.

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

Important

Era dalam kalender Jepang didasarkan pada pemerintahan kaisar dan oleh karena itu diharapkan untuk berubah. Misalnya, 1 Mei 2019 menandai awal era Reiwa di JapaneseCalendar dan JapaneseLunisolarCalendar. Perubahan era seperti itu memengaruhi 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 kesiapan mereka 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 bahwa bumi berputar di sekitar matahari atau waktu aktual bahwa bulan berputar di sekitar bumi, tahun lompatan memiliki jumlah hari yang berbeda dari tahun kalender standar. Setiap Calendar implementasi mendefinisikan tahun kamping secara berbeda.

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

Namespace System.Globalization layanan mencakup implementasi berikut Calendar :

• ChineseLunisolarCalendar

• EastAsianLunisolarCalendar

• GregorianCalendar

• HebrewCalendar

• HijriCalendar

• JapaneseCalendar

• JapaneseLunisolarCalendar

• JulianCalendar

• KoreanCalendar

• KoreanLunisolarCalendar

• PersianCalendar

• TaiwanCalendar

• TaiwanLunisolarCalendar

• ThaiBuddhistCalendar

• UmAlQuraCalendar

Konstruktor

Nama	Deskripsi
Calendar()	Menginisialisasi instans baru dari kelas Calendar.

Bidang

Nama	Deskripsi
CurrentEra	Mewakili era kalender saat ini. Nilai bidang ini adalah 0.

Properti

Nama	Deskripsi
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	Ketika ditimpa di kelas turunan, mendapatkan daftar era di kalender saat ini.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah objek ini Calendar bersifat 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

Nama	Deskripsi
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, mengembalikan DateTime yang merupakan jumlah bulan yang ditentukan dari yang ditentukan DateTime.
AddSeconds(DateTime, Int32)	Mengembalikan DateTime yang merupakan jumlah detik yang ditentukan 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 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 dalam kelas turunan, mengembalikan hari dalam sebulan dalam yang ditentukan DateTime.
GetDayOfWeek(DateTime)	Ketika ditimpa dalam kelas turunan, mengembalikan hari dalam seminggu dalam DateTime.
GetDayOfYear(DateTime)	Ketika ditimpa dalam kelas turunan, mengembalikan hari dalam setahun dalam yang ditentukan DateTime.
GetDaysInMonth(Int32, Int32, Int32)	Saat ditimpa dalam kelas turunan, mengembalikan jumlah hari dalam bulan, tahun, dan era yang ditentukan.
GetDaysInMonth(Int32, Int32)	Mengembalikan jumlah hari dalam bulan dan tahun yang ditentukan dari era saat ini.
GetDaysInYear(Int32, Int32)	Saat ditimpa dalam kelas turunan, mengembalikan jumlah hari dalam tahun dan era yang ditentukan.
GetDaysInYear(Int32)	Mengembalikan jumlah hari dalam tahun yang ditentukan dari era saat ini.
GetEra(DateTime)	Saat ditimpa dalam kelas turunan, mengembalikan era dari DateTime.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHour(DateTime)	Mengembalikan nilai jam dalam DateTime.
GetLeapMonth(Int32, Int32)	Menghitung bulan lompatan untuk tahun dan era tertentu.
GetLeapMonth(Int32)	Menghitung bulan lompatan untuk tahun tertentu.
GetMilliseconds(DateTime)	Mengembalikan nilai milidetik dalam DateTime.
GetMinute(DateTime)	Mengembalikan nilai menit dalam DateTime.
GetMonth(DateTime)	Saat ditimpa dalam kelas turunan, mengembalikan bulan dalam DateTime.
GetMonthsInYear(Int32, Int32)	Ketika ditimpa dalam kelas turunan, mengembalikan jumlah bulan dalam tahun yang ditentukan di era yang ditentukan.
GetMonthsInYear(Int32)	Mengembalikan jumlah bulan dalam tahun yang ditentukan di era saat ini.
GetSecond(DateTime)	Mengembalikan nilai detik dalam DateTime.
GetType()	Mendapatkan Type instans 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, Int32)	Ketika ditimpa dalam kelas turunan, menentukan apakah tanggal yang ditentukan dalam era yang ditentukan adalah hari kabisat.
IsLeapDay(Int32, Int32, Int32)	Menentukan apakah tanggal yang ditentukan di era saat ini adalah hari kampung.
IsLeapMonth(Int32, Int32, Int32)	Ketika ditimpa dalam kelas turunan, menentukan apakah bulan yang ditentukan pada tahun yang ditentukan pada era yang ditentukan adalah bulan kabisat.
IsLeapMonth(Int32, Int32)	Menentukan apakah bulan yang ditentukan pada tahun yang ditentukan di era saat ini adalah bulan kampung.
IsLeapYear(Int32, Int32)	Ketika ditimpa dalam kelas turunan, menentukan apakah tahun yang ditentukan pada era yang ditentukan adalah tahun kabisat.
IsLeapYear(Int32)	Menentukan apakah tahun yang ditentukan pada era saat ini adalah tahun kampung.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ReadOnly(Calendar)	Mengembalikan versi baca-saja dari objek yang ditentukan Calendar .
ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Saat ditimpa dalam kelas turunan, 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.
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

• DateTime
• DateTimeFormatInfo
• ChineseLunisolarCalendar
• EastAsianLunisolarCalendar
• GregorianCalendar
• HebrewCalendar
• HijriCalendar
• JapaneseCalendar
• JapaneseLunisolarCalendar
• JulianCalendar
• KoreanCalendar
• KoreanLunisolarCalendar
• PersianCalendar
• TaiwanCalendar
• TaiwanLunisolarCalendar
• ThaiBuddhistCalendar
• UmAlQuraCalendar
• Bekerja dengan Kalender