GregorianCalendar Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vertegenwoordigt de Gregoriaanse kalender.
public ref class GregorianCalendar : System::Globalization::Calendar
public 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.Calendar
type GregorianCalendar = class
inherit Calendar
[<System.Serializable>]
type GregorianCalendar = class
inherit Calendar
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GregorianCalendar = class
inherit Calendar
Public Class GregorianCalendar
Inherits Calendar
- Overname
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u dat DateTimeFormatInfo de interpunctie in de eranaam wordt genegeerd, alleen als de kalender Gregoriaanse is en de cultuur de eranaam 'A.D' gebruikt.
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
Opmerkingen
De Gregoriaanse kalender herkent twee tijdperken: B.C. of B.C.E., en A.D. of C.E. Deze implementatie van de GregorianCalendar klasse herkent alleen het huidige tijdperk (A.D. of C.E.).
Note
Zie Werk met agenda's voor informatie over het gebruik van de GregorianCalendar-klas en de andere agendaklassen in het .NET Framework.
Een schrikkeljaar in de Gregoriaanse kalender wordt gedefinieerd als een jaar dat gelijkmatig deelbaar is door 4, tenzij het deelbaar is door 100. Jaren die deelbaar zijn door 400 zijn echter schrikkeljaren. Het jaar 1900 was bijvoorbeeld geen schrikkeljaar, maar het jaar 2000. Een gemeenschappelijk jaar heeft 365 dagen en een schrikkeljaar heeft 366 dagen.
De Gregoriaanse kalender heeft 12 maanden met elk 28 tot 31 dagen: januari (31 dagen), februari (28 of 29 dagen), maart (31 dagen), april (30 dagen), mei (30 dagen), mei (30 dagen) 31 dagen), juni (30 dagen), juli (31 dagen), augustus (31 dagen), september (30 dagen), oktober (31 dagen), november (30 dagen) en december (31 dagen). Februari heeft 29 dagen tijdens schrikkeljaren en 28 tijdens gemeenschappelijke jaren.
Important
Standaard drukken alle DateTime waarden DateTimeOffset en waarden datums en tijden uit in de Gregoriaanse kalender.
De Gregoriaanse kalender werd ontwikkeld als vervanging voor de Juliaanse kalender (die wordt vertegenwoordigd door de JulianCalendar klas) en werd voor het eerst geïntroduceerd in een klein aantal culturen op 15 oktober 1582. Wanneer u werkt met historische datums die voorafgaan aan de acceptatie van de Gregoriaanse kalender, moet u de oorspronkelijke kalender gebruiken als deze beschikbaar is in het .NET Framework. Denemarken is bijvoorbeeld gewijzigd van de Juliaanse kalender in de Gregoriaanse kalender op 19 februari (in de Juliaanse kalender) of 1 maart (in de Gregoriaanse kalender) van 1700. In dit geval moet u voor datums vóór de acceptatie van de Gregoriaanse kalender de Juliaanse kalender gebruiken. Houd er echter rekening mee dat geen cultuur intrinsiek ondersteuning biedt voor de JulianCalendar klas. U moet de JulianCalendar klas gebruiken als een zelfstandige agenda. Zie Werken met agenda's voor meer informatie.
In het volgende voorbeeld ziet u dat 18 februari 1700 in de Juliaanse kalender, de laatste dag dat de Juliaanse kalender officieel in Denemarken werd gebruikt, een dag eerder is dan 1 maart 1700 in de Gregoriaanse kalender.
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
Elk CultureInfo ondersteunt een set agenda's. De Calendar eigenschap retourneert de standaardkalender voor de cultuur en de OptionalCalendars eigenschap retourneert een matrix met alle agenda's die door de cultuur worden ondersteund. Als u de agenda wilt wijzigen die door een CultureInfowordt gebruikt, kan de toepassing de Calendar eigenschap instellen op een nieuwe Calendar.
GetEra negeert interpunctie in verkorte eranamen, alleen als de GregorianCalendar selectie is ingeschakeld DateTimeFormatInfo.Calendar en de cultuur 'A.D', als de naam van het tijdperk, 'A.D', gelijk is aan 'AD'.
Constructors
| Name | Description |
|---|---|
| GregorianCalendar() |
Initialiseert een nieuw exemplaar van de GregorianCalendar klasse met behulp van de standaardwaarde GregorianCalendarTypes . |
| GregorianCalendar(GregorianCalendarTypes) |
Initialiseert een nieuw exemplaar van de GregorianCalendar klasse met behulp van de opgegeven GregorianCalendarTypes waarde. |
Velden
| Name | Description |
|---|---|
| ADEra |
Vertegenwoordigt het huidige tijdperk. Dit veld is constant. |
| CurrentEra |
Vertegenwoordigt het huidige tijdperk van de huidige agenda. De waarde van dit veld is 0. (Overgenomen van Calendar) |
Eigenschappen
| Name | Description |
|---|---|
| AlgorithmType |
Hiermee wordt een waarde opgehaald die aangeeft of de huidige kalender op zonne-energie, maanbasis of een combinatie van beide is. |
| CalendarType |
Hiermee wordt de GregorianCalendarTypes waarde opgehaald of ingesteld die de taalversie van de huidige GregorianCalendaraangeeft. |
| DaysInYearBeforeMinSupportedYear |
Hiermee wordt het aantal dagen in het jaar dat voorafgaat aan het jaar dat door de MinSupportedDateTime eigenschap is opgegeven. (Overgenomen van Calendar) |
| Eras |
Hiermee haalt u de lijst met tijdperken in de GregorianCalendar. |
| IsReadOnly |
Hiermee wordt een waarde opgehaald die aangeeft of dit Calendar object het kenmerk Alleen-lezen heeft. (Overgenomen van Calendar) |
| MaxSupportedDateTime |
Hiermee haalt u de meest recente datum en tijd op die door het GregorianCalendar type worden ondersteund. |
| MinSupportedDateTime |
Hiermee haalt u de vroegste datum en tijd op die door het GregorianCalendar type worden ondersteund. |
| TwoDigitYearMax |
Hiermee haalt of stelt u het laatste jaar van een bereik van 100 jaar op dat kan worden vertegenwoordigd door een jaar met twee cijfers. |
Methoden
| Name | Description |
|---|---|
| AddDays(DateTime, Int32) |
Retourneert een DateTime dat het opgegeven aantal dagen weg is van het opgegeven aantal DateTimedagen. (Overgenomen van Calendar) |
| AddHours(DateTime, Int32) |
Retourneert een DateTime getal dat het opgegeven aantal uren weg is van de opgegeven DateTime. (Overgenomen van Calendar) |
| AddMilliseconds(DateTime, Double) |
Retourneert een DateTime waarde die het opgegeven aantal milliseconden is dat niet het opgegeven DateTimeaantal milliseconden is. (Overgenomen van Calendar) |
| AddMinutes(DateTime, Int32) |
Retourneert een DateTime getal dat het opgegeven aantal minuten van de opgegeven DateTimeminuten is. (Overgenomen van Calendar) |
| AddMonths(DateTime, Int32) |
Geeft als resultaat een DateTime getal dat het opgegeven aantal maanden weg is van het opgegeven DateTimeaantal maanden. |
| AddSeconds(DateTime, Int32) |
Retourneert een DateTime getal dat het opgegeven aantal seconden verwijderd is van de opgegeven DateTime. (Overgenomen van Calendar) |
| AddWeeks(DateTime, Int32) |
Geeft als resultaat een DateTime getal dat het opgegeven aantal weken weg is van het opgegeven |
| AddWeeks(DateTime, Int32) |
Geeft als resultaat een DateTime getal dat het opgegeven aantal weken weg is van het opgegeven DateTimeaantal weken. (Overgenomen van Calendar) |
| AddYears(DateTime, Int32) |
Geeft als resultaat een DateTime getal dat het opgegeven aantal jaren weg is van de opgegeven DateTime. |
| Clone() |
Hiermee maakt u een nieuw object dat een kopie van het huidige Calendar object is. (Overgenomen van Calendar) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetDayOfMonth(DateTime) |
Retourneert de dag van de maand in de opgegeven DateTime. |
| GetDayOfWeek(DateTime) |
Retourneert de dag van de week in de opgegeven DateTime. |
| GetDayOfYear(DateTime) |
Retourneert de dag van het jaar in de opgegeven DateTime. |
| GetDaysInMonth(Int32, Int32, Int32) |
Retourneert het aantal dagen in de opgegeven maand in het opgegeven jaar in het opgegeven tijdperk. |
| GetDaysInMonth(Int32, Int32) |
Retourneert het aantal dagen in de opgegeven maand en het jaar van het huidige tijdperk. (Overgenomen van Calendar) |
| GetDaysInYear(Int32, Int32) |
Retourneert het aantal dagen in het opgegeven jaar in het opgegeven tijdperk. |
| GetDaysInYear(Int32) |
Retourneert het aantal dagen in het opgegeven jaar van het huidige tijdperk. (Overgenomen van Calendar) |
| GetEra(DateTime) |
Retourneert het tijdperk in het opgegeven DateTime. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetHour(DateTime) |
Retourneert de urenwaarde in de opgegeven DateTime. (Overgenomen van Calendar) |
| GetLeapMonth(Int32, Int32) |
Berekent de schrikkelmaand voor een bepaald jaar en tijdperk. |
| GetLeapMonth(Int32) |
Berekent de schrikkelmaand voor een bepaald jaar. (Overgenomen van Calendar) |
| GetMilliseconds(DateTime) |
Retourneert de millisecondenwaarde in de opgegeven DateTime. (Overgenomen van Calendar) |
| GetMinute(DateTime) |
Retourneert de minutenwaarde in de opgegeven DateTime. (Overgenomen van Calendar) |
| GetMonth(DateTime) |
Retourneert de maand in de opgegeven DateTime. |
| GetMonthsInYear(Int32, Int32) |
Retourneert het aantal maanden in het opgegeven jaar in het opgegeven tijdperk. |
| GetMonthsInYear(Int32) |
Retourneert het aantal maanden in het opgegeven jaar in het huidige tijdperk. (Overgenomen van Calendar) |
| GetSecond(DateTime) |
Retourneert de secondenwaarde in de opgegeven DateTime. (Overgenomen van Calendar) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Retourneert de week van het jaar met de datum in het opgegeven DateTime object. |
| GetWeekOfYear(DateTime, CalendarWeekRule, DayOfWeek) |
Retourneert de week van het jaar met de datum in de opgegeven DateTime waarde. (Overgenomen van Calendar) |
| GetYear(DateTime) |
Retourneert het jaar in de opgegeven DateTime. |
| IsLeapDay(Int32, Int32, Int32, Int32) |
Bepaalt of de opgegeven datum in het opgegeven tijdperk een schrikkeldag is. |
| IsLeapDay(Int32, Int32, Int32) |
Bepaalt of de opgegeven datum in het huidige tijdperk een schrikkeldag is. (Overgenomen van Calendar) |
| IsLeapMonth(Int32, Int32, Int32) |
Bepaalt of de opgegeven maand in het opgegeven jaar in het opgegeven tijdperk een schrikkelmaand is. |
| IsLeapMonth(Int32, Int32) |
Bepaalt of de opgegeven maand in het opgegeven jaar in het huidige tijdperk een schrikkelmaand is. (Overgenomen van Calendar) |
| IsLeapYear(Int32, Int32) |
Bepaalt of het opgegeven jaar in het opgegeven tijdperk een schrikkeljaar is. |
| IsLeapYear(Int32) |
Bepaalt of het opgegeven jaar in het huidige tijdperk een schrikkeljaar is. (Overgenomen van Calendar) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Hiermee wordt een DateTime waarde geretourneerd die is ingesteld op de opgegeven datum en tijd in het opgegeven tijdperk. |
| ToDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Hiermee wordt een DateTime waarde geretourneerd die is ingesteld op de opgegeven datum en tijd in het huidige tijdperk. (Overgenomen van Calendar) |
| ToFourDigitYear(Int32) |
Converteert het opgegeven jaar naar een jaar van vier cijfers met behulp van de TwoDigitYearMax eigenschap om de juiste eeuw te bepalen. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |