Merge pull request #926 from ermshiperete/novell-bug-674098
[mono.git] / mcs / class / corlib / Documentation / en / System.Globalization / GregorianCalendar.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <Type Name="GregorianCalendar" FullName="System.Globalization.GregorianCalendar">
3   <TypeSignature Maintainer="auto" Language="C#" Value="public class GregorianCalendar : System.Globalization.Calendar" />
4   <TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit GregorianCalendar extends System.Globalization.Calendar" />
5   <AssemblyInfo>
6     <AssemblyName>mscorlib</AssemblyName>
7     <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
8     <AssemblyVersion>1.0.5000.0</AssemblyVersion>
9     <AssemblyVersion>2.0.0.0</AssemblyVersion>
10     <AssemblyVersion>4.0.0.0</AssemblyVersion>
11   </AssemblyInfo>
12   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
13   <Base>
14     <BaseTypeName>System.Globalization.Calendar</BaseTypeName>
15   </Base>
16   <Interfaces />
17   <Attributes>
18     <Attribute>
19       <AttributeName>System.Runtime.InteropServices.ComVisible(true)</AttributeName>
20     </Attribute>
21   </Attributes>
22   <Docs>
23     <remarks>
24       <attribution license="cc4" from="Microsoft" modified="false" />
25       <para>The Gregorian calendar recognizes two eras: B.C. or B.C.E., and A.D. or C.E. This implementation of the <see cref="T:System.Globalization.GregorianCalendar" /> class recognizes only the current era (A.D. or C.E.).</para>
26       <block subset="none" type="note">
27         <para>For information about using the <see cref="T:System.Globalization.GregorianCalendar" /> class and the other calendar classes in the .NET Framework, see <format type="text/html"><a href="0c1534e5-979b-4c8a-a588-1c24301aefb3">Working with Calendars</a></format>.</para>
28       </block>
29       <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by 4, unless it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
30       <para>The Gregorian calendar has 12 months with 28 to 31 days each: January (31 days), February (28 or 29 days), March (31 days), April (30 days), May (31 days), June (30 days), July (31 days), August (31 days), September (30 days), October (31 days), November (30 days), and December (31 days). February has 29 days during leap years and 28 during common years.</para>
31       <block subset="none" type="note">
32         <para>By default, all <see cref="T:System.DateTime" /> and <see cref="T:System.DateTimeOffset" /> values express dates and times in the Gregorian calendar. </para>
33       </block>
34       <para>The Gregorian calendar was developed as a replacement for the Julian calendar (which is represented by the <see cref="T:System.Globalization.JulianCalendar" /> class) and was first introduced in a small number of cultures on October 15, 1582. When working with historic dates that precede a culture's adoption of the Gregorian calendar, you should use the original calendar if it is available in the .NET Framework. For example, Denmark changed from the Julian calendar to the Gregorian calendar on February 19 (in the Julian calendar) or March 1 (in the Gregorian calendar) of 1700. In this case, for dates before the adoption of the Gregorian calendar, you should use the Julian calendar. However, note that no culture offers intrinsic support for the <see cref="T:System.Globalization.JulianCalendar" /> class. You must use the <see cref="T:System.Globalization.JulianCalendar" /> class as a standalone calendar. For more information, see <format type="text/html"><a href="0c1534e5-979b-4c8a-a588-1c24301aefb3">Working with Calendars</a></format>. </para>
35       <para>The following example illustrates that February 18, 1700 in the Julian calendar, which is the last day the Julian calendar was officially used in Denmark, is one day earlier than March 1, 1700 in the Gregorian calendar.</para>
36       <para>code reference: System.Globalization.GregorianCalendar.Class#1</para>
37       <para>Each <see cref="T:System.Globalization.CultureInfo" /> supports a set of calendars. The <see cref="P:System.Globalization.CultureInfo.Calendar" /> property returns the default calendar for the culture, and the <see cref="P:System.Globalization.CultureInfo.OptionalCalendars" /> property returns an array containing all the calendars supported by the culture. To change the calendar used by a <see cref="T:System.Globalization.CultureInfo" />, the application can set the <see cref="P:System.Globalization.DateTimeFormatInfo.Calendar" /> property to a new <see cref="T:System.Globalization.Calendar" />.</para>
38       <para>
39         <see cref="M:System.Globalization.DateTimeFormatInfo.GetEra(System.String)" /> ignores punctuation in abbreviated era names, only if the <see cref="T:System.Globalization.GregorianCalendar" /> is selected in <see cref="P:System.Globalization.DateTimeFormatInfo.Calendar" /> and the culture uses "A.D." as the era name, that is, "A.D." is equivalent to "AD".</para>
40     </remarks>
41     <summary>
42       <attribution license="cc4" from="Microsoft" modified="false" />
43       <para>Represents the Gregorian calendar.</para>
44     </summary>
45   </Docs>
46   <Members>
47     <Member MemberName=".ctor">
48       <MemberSignature Language="C#" Value="public GregorianCalendar ();" />
49       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
50       <MemberType>Constructor</MemberType>
51       <AssemblyInfo>
52         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
53         <AssemblyVersion>2.0.0.0</AssemblyVersion>
54         <AssemblyVersion>4.0.0.0</AssemblyVersion>
55       </AssemblyInfo>
56       <ReturnValue />
57       <Parameters />
58       <Docs>
59         <remarks>
60           <attribution license="cc4" from="Microsoft" modified="false" />
61           <para>The default <see cref="T:System.Globalization.GregorianCalendarTypes" /> value is <see cref="F:System.Globalization.GregorianCalendarTypes.Localized" />. If the <see cref="P:System.Globalization.DateTimeFormatInfo.Calendar" /> property of the <see cref="T:System.Globalization.CultureInfo" /> is set to a <see cref="T:System.Globalization.GregorianCalendar" /> that is created with this constructor, the dates and times are localized in the language associated with the <see cref="T:System.Globalization.CultureInfo" />.</para>
62         </remarks>
63         <summary>
64           <attribution license="cc4" from="Microsoft" modified="false" />
65           <para>Initializes a new instance of the <see cref="T:System.Globalization.GregorianCalendar" /> class using the default <see cref="T:System.Globalization.GregorianCalendarTypes" /> value.</para>
66         </summary>
67       </Docs>
68     </Member>
69     <Member MemberName=".ctor">
70       <MemberSignature Language="C#" Value="public GregorianCalendar (System.Globalization.GregorianCalendarTypes type);" />
71       <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.Globalization.GregorianCalendarTypes type) cil managed" />
72       <MemberType>Constructor</MemberType>
73       <AssemblyInfo>
74         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
75         <AssemblyVersion>2.0.0.0</AssemblyVersion>
76         <AssemblyVersion>4.0.0.0</AssemblyVersion>
77       </AssemblyInfo>
78       <ReturnValue />
79       <Parameters>
80         <Parameter Name="type" Type="System.Globalization.GregorianCalendarTypes" />
81       </Parameters>
82       <Docs>
83         <remarks>To be added</remarks>
84         <summary>
85           <attribution license="cc4" from="Microsoft" modified="false" />
86           <para>Initializes a new instance of the <see cref="T:System.Globalization.GregorianCalendar" /> class using the specified <see cref="T:System.Globalization.GregorianCalendarTypes" /> value.</para>
87         </summary>
88         <param name="type">
89           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.GregorianCalendarTypes" /> value that denotes which language version of the calendar to create. </param>
90       </Docs>
91     </Member>
92     <Member MemberName="AddMonths">
93       <MemberSignature Language="C#" Value="public override DateTime AddMonths (DateTime time, int months);" />
94       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance valuetype System.DateTime AddMonths(valuetype System.DateTime time, int32 months) cil managed" />
95       <MemberType>Method</MemberType>
96       <AssemblyInfo>
97         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
98         <AssemblyVersion>2.0.0.0</AssemblyVersion>
99         <AssemblyVersion>4.0.0.0</AssemblyVersion>
100       </AssemblyInfo>
101       <ReturnValue>
102         <ReturnType>System.DateTime</ReturnType>
103       </ReturnValue>
104       <Parameters>
105         <Parameter Name="time" Type="System.DateTime" />
106         <Parameter Name="months" Type="System.Int32" />
107       </Parameters>
108       <Docs>
109         <remarks>
110           <attribution license="cc4" from="Microsoft" modified="false" />
111           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
112           <para>For example, if the specified month is October, which has 31 days, the specified day is the 31st day of that month, and the value of the <paramref name="months" /> parameter is 6, the resulting year is one more than the specified year, the resulting month is April, and the resulting day is the 30th day, which is the last day in April.</para>
113           <para>If the value of the <paramref name="months" /> parameter is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
114           <para>The <see cref="P:System.DateTime.Kind" /> property of the returned <see cref="T:System.DateTime" /> value always equals <see cref="F:System.DateTimeKind.Unspecified" />. You can preserve the <see cref="P:System.DateTime.Kind" /> property of the <paramref name="time" /> parameter by calling the <see cref="M:System.DateTime.SpecifyKind(System.DateTime,System.DateTimeKind)" /> method, as the following example shows.</para>
115           <para>code reference: System.Globalization.Calendar.AddMethods#5</para>
116         </remarks>
117         <summary>
118           <attribution license="cc4" from="Microsoft" modified="false" />
119           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
120         </summary>
121         <returns>
122           <attribution license="cc4" from="Microsoft" modified="false" />
123           <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
124         </returns>
125         <param name="time">
126           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
127         <param name="months">
128           <attribution license="cc4" from="Microsoft" modified="false" />The number of months to add. </param>
129       </Docs>
130     </Member>
131     <Member MemberName="AddYears">
132       <MemberSignature Language="C#" Value="public override DateTime AddYears (DateTime time, int years);" />
133       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance valuetype System.DateTime AddYears(valuetype System.DateTime time, int32 years) cil managed" />
134       <MemberType>Method</MemberType>
135       <AssemblyInfo>
136         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
137         <AssemblyVersion>2.0.0.0</AssemblyVersion>
138         <AssemblyVersion>4.0.0.0</AssemblyVersion>
139       </AssemblyInfo>
140       <ReturnValue>
141         <ReturnType>System.DateTime</ReturnType>
142       </ReturnValue>
143       <Parameters>
144         <Parameter Name="time" Type="System.DateTime" />
145         <Parameter Name="years" Type="System.Int32" />
146       </Parameters>
147       <Docs>
148         <remarks>
149           <attribution license="cc4" from="Microsoft" modified="false" />
150           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
151           <para>For example, February has 28 days, except during leap years when it has 29 days. If the specified date is the 29th day of February in a leap year and the value of <paramref name="years" /> is 1, the resulting date will be the 28th day of February in the following year.</para>
152           <para>If <paramref name="years" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
153           <para>The <see cref="P:System.DateTime.Kind" /> property of the returned <see cref="T:System.DateTime" /> value always equals <see cref="F:System.DateTimeKind.Unspecified" />. You can preserve the <see cref="P:System.DateTime.Kind" /> property of the <paramref name="time" /> parameter by calling the <see cref="M:System.DateTime.SpecifyKind(System.DateTime,System.DateTimeKind)" /> method, as the following example shows.</para>
154           <para>code reference: System.Globalization.Calendar.AddMethods#8</para>
155         </remarks>
156         <summary>
157           <attribution license="cc4" from="Microsoft" modified="false" />
158           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
159         </summary>
160         <returns>
161           <attribution license="cc4" from="Microsoft" modified="false" />
162           <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
163         </returns>
164         <param name="time">
165           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
166         <param name="years">
167           <attribution license="cc4" from="Microsoft" modified="false" />The number of years to add. </param>
168       </Docs>
169     </Member>
170     <Member MemberName="ADEra">
171       <MemberSignature Language="C#" Value="public const int ADEra = 1;" />
172       <MemberSignature Language="ILAsm" Value=".field public static literal int32 ADEra = (1)" />
173       <MemberType>Field</MemberType>
174       <AssemblyInfo>
175         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
176         <AssemblyVersion>2.0.0.0</AssemblyVersion>
177         <AssemblyVersion>4.0.0.0</AssemblyVersion>
178       </AssemblyInfo>
179       <ReturnValue>
180         <ReturnType>System.Int32</ReturnType>
181       </ReturnValue>
182       <Parameters />
183       <MemberValue>1</MemberValue>
184       <Docs>
185         <remarks>
186           <attribution license="cc4" from="Microsoft" modified="false" />
187           <para>The Gregorian calendar recognizes two eras: B.C. or B.C.E., and A.D. or C.E. This implementation of the <see cref="T:System.Globalization.GregorianCalendar" /> class recognizes only the current era (A.D. or C.E.). This field always returns 1.</para>
188         </remarks>
189         <summary>
190           <attribution license="cc4" from="Microsoft" modified="false" />
191           <para>Represents the current era. This field is constant.</para>
192         </summary>
193       </Docs>
194     </Member>
195     <Member MemberName="AlgorithmType">
196       <MemberSignature Language="C#" Value="public override System.Globalization.CalendarAlgorithmType AlgorithmType { get; }" />
197       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.Globalization.CalendarAlgorithmType AlgorithmType" />
198       <MemberType>Property</MemberType>
199       <AssemblyInfo>
200         <AssemblyVersion>2.0.0.0</AssemblyVersion>
201         <AssemblyVersion>4.0.0.0</AssemblyVersion>
202       </AssemblyInfo>
203       <Attributes>
204         <Attribute>
205           <AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
206         </Attribute>
207       </Attributes>
208       <ReturnValue>
209         <ReturnType>System.Globalization.CalendarAlgorithmType</ReturnType>
210       </ReturnValue>
211       <Docs>
212         <value>To be added.</value>
213         <remarks>To be added.</remarks>
214         <since version=".NET 2.0" />
215         <summary>
216           <attribution license="cc4" from="Microsoft" modified="false" />
217           <para>Gets a value that indicates whether the current calendar is solar-based, lunar-based, or a combination of both.</para>
218         </summary>
219       </Docs>
220     </Member>
221     <Member MemberName="CalendarType">
222       <MemberSignature Language="C#" Value="public virtual System.Globalization.GregorianCalendarTypes CalendarType { get; set; }" />
223       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.Globalization.GregorianCalendarTypes CalendarType" />
224       <MemberType>Property</MemberType>
225       <AssemblyInfo>
226         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
227         <AssemblyVersion>2.0.0.0</AssemblyVersion>
228         <AssemblyVersion>4.0.0.0</AssemblyVersion>
229       </AssemblyInfo>
230       <ReturnValue>
231         <ReturnType>System.Globalization.GregorianCalendarTypes</ReturnType>
232       </ReturnValue>
233       <Parameters>
234       </Parameters>
235       <Docs>
236         <value>To be added: an object of type 'GregorianCalendarTypes'</value>
237         <remarks>To be added</remarks>
238         <summary>
239           <attribution license="cc4" from="Microsoft" modified="false" />
240           <para>Gets or sets the <see cref="T:System.Globalization.GregorianCalendarTypes" /> value that denotes the language version of the current <see cref="T:System.Globalization.GregorianCalendar" />.</para>
241         </summary>
242       </Docs>
243     </Member>
244     <Member MemberName="Eras">
245       <MemberSignature Language="C#" Value="public override int[] Eras { get; }" />
246       <MemberSignature Language="ILAsm" Value=".property instance int32[] Eras" />
247       <MemberType>Property</MemberType>
248       <AssemblyInfo>
249         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
250         <AssemblyVersion>2.0.0.0</AssemblyVersion>
251         <AssemblyVersion>4.0.0.0</AssemblyVersion>
252       </AssemblyInfo>
253       <ReturnValue>
254         <ReturnType>System.Int32[]</ReturnType>
255       </ReturnValue>
256       <Docs>
257         <value>To be added.</value>
258         <remarks>
259           <attribution license="cc4" from="Microsoft" modified="false" />
260           <para>The Gregorian calendar recognizes two eras: B.C. or B.C.E., and A.D. or C.E. This implementation of the <see cref="T:System.Globalization.GregorianCalendar" /> class recognizes only the current era (A.D. or C.E.). This property always returns an array with only one element.</para>
261         </remarks>
262         <summary>
263           <attribution license="cc4" from="Microsoft" modified="false" />
264           <para>Gets the list of eras in the <see cref="T:System.Globalization.GregorianCalendar" />.</para>
265         </summary>
266       </Docs>
267     </Member>
268     <Member MemberName="GetDayOfMonth">
269       <MemberSignature Language="C#" Value="public override int GetDayOfMonth (DateTime time);" />
270       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetDayOfMonth(valuetype System.DateTime time) cil managed" />
271       <MemberType>Method</MemberType>
272       <AssemblyInfo>
273         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
274         <AssemblyVersion>2.0.0.0</AssemblyVersion>
275         <AssemblyVersion>4.0.0.0</AssemblyVersion>
276       </AssemblyInfo>
277       <ReturnValue>
278         <ReturnType>System.Int32</ReturnType>
279       </ReturnValue>
280       <Parameters>
281         <Parameter Name="time" Type="System.DateTime" />
282       </Parameters>
283       <Docs>
284         <remarks>To be added.</remarks>
285         <summary>
286           <attribution license="cc4" from="Microsoft" modified="false" />
287           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
288         </summary>
289         <returns>
290           <attribution license="cc4" from="Microsoft" modified="false" />
291           <para>An integer from 1 to 31 that represents the day of the month in <paramref name="time" />.</para>
292         </returns>
293         <param name="time">
294           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
295       </Docs>
296     </Member>
297     <Member MemberName="GetDayOfWeek">
298       <MemberSignature Language="C#" Value="public override DayOfWeek GetDayOfWeek (DateTime time);" />
299       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance valuetype System.DayOfWeek GetDayOfWeek(valuetype System.DateTime time) cil managed" />
300       <MemberType>Method</MemberType>
301       <AssemblyInfo>
302         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
303         <AssemblyVersion>2.0.0.0</AssemblyVersion>
304         <AssemblyVersion>4.0.0.0</AssemblyVersion>
305       </AssemblyInfo>
306       <ReturnValue>
307         <ReturnType>System.DayOfWeek</ReturnType>
308       </ReturnValue>
309       <Parameters>
310         <Parameter Name="time" Type="System.DateTime" />
311       </Parameters>
312       <Docs>
313         <remarks>
314           <attribution license="cc4" from="Microsoft" modified="false" />
315           <para>The <see cref="T:System.DayOfWeek" /> values are Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, and Saturday.</para>
316         </remarks>
317         <summary>
318           <attribution license="cc4" from="Microsoft" modified="false" />
319           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
320         </summary>
321         <returns>
322           <attribution license="cc4" from="Microsoft" modified="false" />
323           <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in <paramref name="time" />.</para>
324         </returns>
325         <param name="time">
326           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
327       </Docs>
328     </Member>
329     <Member MemberName="GetDayOfYear">
330       <MemberSignature Language="C#" Value="public override int GetDayOfYear (DateTime time);" />
331       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetDayOfYear(valuetype System.DateTime time) cil managed" />
332       <MemberType>Method</MemberType>
333       <AssemblyInfo>
334         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
335         <AssemblyVersion>2.0.0.0</AssemblyVersion>
336         <AssemblyVersion>4.0.0.0</AssemblyVersion>
337       </AssemblyInfo>
338       <ReturnValue>
339         <ReturnType>System.Int32</ReturnType>
340       </ReturnValue>
341       <Parameters>
342         <Parameter Name="time" Type="System.DateTime" />
343       </Parameters>
344       <Docs>
345         <remarks>
346           <attribution license="cc4" from="Microsoft" modified="false" />
347           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.GregorianCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.GregorianCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year, which is the same value returned by <see cref="M:System.Globalization.GregorianCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
348         </remarks>
349         <summary>
350           <attribution license="cc4" from="Microsoft" modified="false" />
351           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
352         </summary>
353         <returns>
354           <attribution license="cc4" from="Microsoft" modified="false" />
355           <para>An integer from 1 to 366 that represents the day of the year in <paramref name="time" />.</para>
356         </returns>
357         <param name="time">
358           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
359       </Docs>
360     </Member>
361     <Member MemberName="GetDaysInMonth">
362       <MemberSignature Language="C#" Value="public override int GetDaysInMonth (int year, int month, int era);" />
363       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetDaysInMonth(int32 year, int32 month, int32 era) cil managed" />
364       <MemberType>Method</MemberType>
365       <AssemblyInfo>
366         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
367         <AssemblyVersion>2.0.0.0</AssemblyVersion>
368         <AssemblyVersion>4.0.0.0</AssemblyVersion>
369       </AssemblyInfo>
370       <ReturnValue>
371         <ReturnType>System.Int32</ReturnType>
372       </ReturnValue>
373       <Parameters>
374         <Parameter Name="year" Type="System.Int32" />
375         <Parameter Name="month" Type="System.Int32" />
376         <Parameter Name="era" Type="System.Int32" />
377       </Parameters>
378       <Docs>
379         <remarks>
380           <attribution license="cc4" from="Microsoft" modified="false" />
381           <para>For example, this method returns 28 or 29 for February (<paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
382         </remarks>
383         <summary>
384           <attribution license="cc4" from="Microsoft" modified="false" />
385           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
386         </summary>
387         <returns>
388           <attribution license="cc4" from="Microsoft" modified="false" />
389           <para>The number of days in the specified month in the specified year in the specified era.</para>
390         </returns>
391         <param name="year">
392           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
393         <param name="month">
394           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 to 12 that represents the month. </param>
395         <param name="era">
396           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
397       </Docs>
398     </Member>
399     <Member MemberName="GetDaysInYear">
400       <MemberSignature Language="C#" Value="public override int GetDaysInYear (int year, int era);" />
401       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetDaysInYear(int32 year, int32 era) cil managed" />
402       <MemberType>Method</MemberType>
403       <AssemblyInfo>
404         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
405         <AssemblyVersion>2.0.0.0</AssemblyVersion>
406         <AssemblyVersion>4.0.0.0</AssemblyVersion>
407       </AssemblyInfo>
408       <ReturnValue>
409         <ReturnType>System.Int32</ReturnType>
410       </ReturnValue>
411       <Parameters>
412         <Parameter Name="year" Type="System.Int32" />
413         <Parameter Name="era" Type="System.Int32" />
414       </Parameters>
415       <Docs>
416         <remarks>
417           <attribution license="cc4" from="Microsoft" modified="false" />
418           <para>For example, this method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
419         </remarks>
420         <summary>
421           <attribution license="cc4" from="Microsoft" modified="false" />
422           <para>Returns the number of days in the specified year in the specified era.</para>
423         </summary>
424         <returns>
425           <attribution license="cc4" from="Microsoft" modified="false" />
426           <para>The number of days in the specified year in the specified era.</para>
427         </returns>
428         <param name="year">
429           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
430         <param name="era">
431           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
432       </Docs>
433     </Member>
434     <Member MemberName="GetEra">
435       <MemberSignature Language="C#" Value="public override int GetEra (DateTime time);" />
436       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetEra(valuetype System.DateTime time) cil managed" />
437       <MemberType>Method</MemberType>
438       <AssemblyInfo>
439         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
440         <AssemblyVersion>2.0.0.0</AssemblyVersion>
441         <AssemblyVersion>4.0.0.0</AssemblyVersion>
442       </AssemblyInfo>
443       <ReturnValue>
444         <ReturnType>System.Int32</ReturnType>
445       </ReturnValue>
446       <Parameters>
447         <Parameter Name="time" Type="System.DateTime" />
448       </Parameters>
449       <Docs>
450         <remarks>
451           <attribution license="cc4" from="Microsoft" modified="false" />
452           <para>The Gregorian calendar recognizes two eras: B.C. or B.C.E., and A.D. or C.E. This implementation of the <see cref="T:System.Globalization.GregorianCalendar" /> class recognizes only the current era (A.D. or C.E.).</para>
453         </remarks>
454         <summary>
455           <attribution license="cc4" from="Microsoft" modified="false" />
456           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
457         </summary>
458         <returns>
459           <attribution license="cc4" from="Microsoft" modified="false" />
460           <para>An integer that represents the era in <paramref name="time" />.</para>
461         </returns>
462         <param name="time">
463           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
464       </Docs>
465     </Member>
466     <Member MemberName="GetLeapMonth">
467       <MemberSignature Language="C#" Value="public override int GetLeapMonth (int year, int era);" />
468       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetLeapMonth(int32 year, int32 era) cil managed" />
469       <MemberType>Method</MemberType>
470       <AssemblyInfo>
471         <AssemblyVersion>2.0.0.0</AssemblyVersion>
472         <AssemblyVersion>4.0.0.0</AssemblyVersion>
473       </AssemblyInfo>
474       <Attributes>
475         <Attribute>
476           <AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
477         </Attribute>
478       </Attributes>
479       <ReturnValue>
480         <ReturnType>System.Int32</ReturnType>
481       </ReturnValue>
482       <Parameters>
483         <Parameter Name="year" Type="System.Int32" />
484         <Parameter Name="era" Type="System.Int32" />
485       </Parameters>
486       <Docs>
487         <remarks>To be added.</remarks>
488         <summary>
489           <attribution license="cc4" from="Microsoft" modified="false" />
490           <para>Calculates the leap month for a specified year and era.</para>
491         </summary>
492         <returns>
493           <attribution license="cc4" from="Microsoft" modified="false" />
494           <para>Always 0 because the Gregorian calendar does not recognize leap months.</para>
495         </returns>
496         <param name="year">
497           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
498         <param name="era">
499           <attribution license="cc4" from="Microsoft" modified="false" />An era. Specify either <see cref="F:System.Globalization.GregorianCalendar.ADEra" /> or GregorianCalendar.Eras[Calendar.CurrentEra].</param>
500       </Docs>
501     </Member>
502     <Member MemberName="GetMonth">
503       <MemberSignature Language="C#" Value="public override int GetMonth (DateTime time);" />
504       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetMonth(valuetype System.DateTime time) cil managed" />
505       <MemberType>Method</MemberType>
506       <AssemblyInfo>
507         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
508         <AssemblyVersion>2.0.0.0</AssemblyVersion>
509         <AssemblyVersion>4.0.0.0</AssemblyVersion>
510       </AssemblyInfo>
511       <ReturnValue>
512         <ReturnType>System.Int32</ReturnType>
513       </ReturnValue>
514       <Parameters>
515         <Parameter Name="time" Type="System.DateTime" />
516       </Parameters>
517       <Docs>
518         <remarks>To be added.</remarks>
519         <summary>
520           <attribution license="cc4" from="Microsoft" modified="false" />
521           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
522         </summary>
523         <returns>
524           <attribution license="cc4" from="Microsoft" modified="false" />
525           <para>An integer from 1 to 12 that represents the month in <paramref name="time" />.</para>
526         </returns>
527         <param name="time">
528           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
529       </Docs>
530     </Member>
531     <Member MemberName="GetMonthsInYear">
532       <MemberSignature Language="C#" Value="public override int GetMonthsInYear (int year, int era);" />
533       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetMonthsInYear(int32 year, int32 era) cil managed" />
534       <MemberType>Method</MemberType>
535       <AssemblyInfo>
536         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
537         <AssemblyVersion>2.0.0.0</AssemblyVersion>
538         <AssemblyVersion>4.0.0.0</AssemblyVersion>
539       </AssemblyInfo>
540       <ReturnValue>
541         <ReturnType>System.Int32</ReturnType>
542       </ReturnValue>
543       <Parameters>
544         <Parameter Name="year" Type="System.Int32" />
545         <Parameter Name="era" Type="System.Int32" />
546       </Parameters>
547       <Docs>
548         <remarks>To be added.</remarks>
549         <summary>
550           <attribution license="cc4" from="Microsoft" modified="false" />
551           <para>Returns the number of months in the specified year in the specified era.</para>
552         </summary>
553         <returns>
554           <attribution license="cc4" from="Microsoft" modified="false" />
555           <para>The number of months in the specified year in the specified era.</para>
556         </returns>
557         <param name="year">
558           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
559         <param name="era">
560           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
561       </Docs>
562     </Member>
563     <Member MemberName="GetWeekOfYear">
564       <MemberSignature Language="C#" Value="public override int GetWeekOfYear (DateTime time, System.Globalization.CalendarWeekRule rule, DayOfWeek firstDayOfWeek);" />
565       <MemberType>Method</MemberType>
566       <AssemblyInfo>
567         <AssemblyVersion>2.0.0.0</AssemblyVersion>
568       </AssemblyInfo>
569       <Attributes>
570         <Attribute>
571           <AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
572         </Attribute>
573       </Attributes>
574       <ReturnValue>
575         <ReturnType>System.Int32</ReturnType>
576       </ReturnValue>
577       <Parameters>
578         <Parameter Name="time" Type="System.DateTime" />
579         <Parameter Name="rule" Type="System.Globalization.CalendarWeekRule" />
580         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
581       </Parameters>
582       <Docs>
583         <remarks>
584           <attribution license="cc4" from="Microsoft" modified="false" />
585           <para>This method can be used to determine the number of weeks in the year by setting the <paramref name="time" /> parameter to the last day of the year.</para>
586           <para>The <see cref="P:System.Globalization.CultureInfo.DateTimeFormat" /> property contains culture-specific values that can be used for the <paramref name="rule" /> and <paramref name="firstDayOfWeek" /> parameters.</para>
587           <para>The <see cref="P:System.Globalization.DateTimeFormatInfo.FirstDayOfWeek" /> property of <see cref="P:System.Globalization.CultureInfo.DateTimeFormat" /> contains the default <see cref="T:System.DayOfWeek" /> value that represents the first day of the week for a specific culture, using the calendar specified in the <see cref="P:System.Globalization.DateTimeFormatInfo.Calendar" /> property of <see cref="P:System.Globalization.CultureInfo.DateTimeFormat" />.</para>
588           <para>The <see cref="P:System.Globalization.DateTimeFormatInfo.CalendarWeekRule" /> property of <see cref="P:System.Globalization.CultureInfo.DateTimeFormat" /> contains the default <see cref="T:System.Globalization.CalendarWeekRule" /> value that defines a calendar week for a specific culture, using the calendar specified in the <see cref="P:System.Globalization.DateTimeFormatInfo.Calendar" /> property of <see cref="P:System.Globalization.CultureInfo.DateTimeFormat" />.</para>
589           <para>For example, in <see cref="T:System.Globalization.GregorianCalendar" />, the <see cref="M:System.Globalization.Calendar.GetWeekOfYear(System.DateTime,System.Globalization.CalendarWeekRule,System.DayOfWeek)" /> method for January 1 returns 1.</para>
590         </remarks>
591         <summary>
592           <attribution license="cc4" from="Microsoft" modified="false" />
593           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" /> object.</para>
594         </summary>
595         <returns>
596           <attribution license="cc4" from="Microsoft" modified="false" />
597           <para>A 1-based integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
598         </returns>
599         <param name="time">
600           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> object to read. </param>
601         <param name="rule">
602           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Globalization.CalendarWeekRule" /> values that defines a calendar week. </param>
603         <param name="firstDayOfWeek">
604           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.DayOfWeek" /> values that represents the first day of the week. </param>
605       </Docs>
606     </Member>
607     <Member MemberName="GetYear">
608       <MemberSignature Language="C#" Value="public override int GetYear (DateTime time);" />
609       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 GetYear(valuetype System.DateTime time) cil managed" />
610       <MemberType>Method</MemberType>
611       <AssemblyInfo>
612         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
613         <AssemblyVersion>2.0.0.0</AssemblyVersion>
614         <AssemblyVersion>4.0.0.0</AssemblyVersion>
615       </AssemblyInfo>
616       <ReturnValue>
617         <ReturnType>System.Int32</ReturnType>
618       </ReturnValue>
619       <Parameters>
620         <Parameter Name="time" Type="System.DateTime" />
621       </Parameters>
622       <Docs>
623         <remarks>To be added.</remarks>
624         <summary>
625           <attribution license="cc4" from="Microsoft" modified="false" />
626           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
627         </summary>
628         <returns>
629           <attribution license="cc4" from="Microsoft" modified="false" />
630           <para>An integer that represents the year in <paramref name="time" />.</para>
631         </returns>
632         <param name="time">
633           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
634       </Docs>
635     </Member>
636     <Member MemberName="IsLeapDay">
637       <MemberSignature Language="C#" Value="public override bool IsLeapDay (int year, int month, int day, int era);" />
638       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool IsLeapDay(int32 year, int32 month, int32 day, int32 era) cil managed" />
639       <MemberType>Method</MemberType>
640       <AssemblyInfo>
641         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
642         <AssemblyVersion>2.0.0.0</AssemblyVersion>
643         <AssemblyVersion>4.0.0.0</AssemblyVersion>
644       </AssemblyInfo>
645       <ReturnValue>
646         <ReturnType>System.Boolean</ReturnType>
647       </ReturnValue>
648       <Parameters>
649         <Parameter Name="year" Type="System.Int32" />
650         <Parameter Name="month" Type="System.Int32" />
651         <Parameter Name="day" Type="System.Int32" />
652         <Parameter Name="era" Type="System.Int32" />
653       </Parameters>
654       <Docs>
655         <remarks>
656           <attribution license="cc4" from="Microsoft" modified="false" />
657           <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
658           <para>A leap day is a day that occurs only in a leap year. In the Gregorian calendar, the 29th day of February is the only leap day.</para>
659         </remarks>
660         <summary>
661           <attribution license="cc4" from="Microsoft" modified="false" />
662           <para>Determines whether the specified date in the specified era is a leap day.</para>
663         </summary>
664         <returns>
665           <attribution license="cc4" from="Microsoft" modified="false" />
666           <para>true if the specified day is a leap day; otherwise, false.</para>
667         </returns>
668         <param name="year">
669           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
670         <param name="month">
671           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 to 12 that represents the month. </param>
672         <param name="day">
673           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 to 31 that represents the day. </param>
674         <param name="era">
675           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
676       </Docs>
677     </Member>
678     <Member MemberName="IsLeapMonth">
679       <MemberSignature Language="C#" Value="public override bool IsLeapMonth (int year, int month, int era);" />
680       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool IsLeapMonth(int32 year, int32 month, int32 era) cil managed" />
681       <MemberType>Method</MemberType>
682       <AssemblyInfo>
683         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
684         <AssemblyVersion>2.0.0.0</AssemblyVersion>
685         <AssemblyVersion>4.0.0.0</AssemblyVersion>
686       </AssemblyInfo>
687       <ReturnValue>
688         <ReturnType>System.Boolean</ReturnType>
689       </ReturnValue>
690       <Parameters>
691         <Parameter Name="year" Type="System.Int32" />
692         <Parameter Name="month" Type="System.Int32" />
693         <Parameter Name="era" Type="System.Int32" />
694       </Parameters>
695       <Docs>
696         <remarks>
697           <attribution license="cc4" from="Microsoft" modified="false" />
698           <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
699           <para>A leap month is an entire month that occurs only in a leap year. The Gregorian calendar does not have any leap months.</para>
700         </remarks>
701         <summary>
702           <attribution license="cc4" from="Microsoft" modified="false" />
703           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
704         </summary>
705         <returns>
706           <attribution license="cc4" from="Microsoft" modified="false" />
707           <para>This method always returns false, unless overridden by a derived class.</para>
708         </returns>
709         <param name="year">
710           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
711         <param name="month">
712           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 to 12 that represents the month. </param>
713         <param name="era">
714           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
715       </Docs>
716     </Member>
717     <Member MemberName="IsLeapYear">
718       <MemberSignature Language="C#" Value="public override bool IsLeapYear (int year, int era);" />
719       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance bool IsLeapYear(int32 year, int32 era) cil managed" />
720       <MemberType>Method</MemberType>
721       <AssemblyInfo>
722         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
723         <AssemblyVersion>2.0.0.0</AssemblyVersion>
724         <AssemblyVersion>4.0.0.0</AssemblyVersion>
725       </AssemblyInfo>
726       <ReturnValue>
727         <ReturnType>System.Boolean</ReturnType>
728       </ReturnValue>
729       <Parameters>
730         <Parameter Name="year" Type="System.Int32" />
731         <Parameter Name="era" Type="System.Int32" />
732       </Parameters>
733       <Docs>
734         <remarks>
735           <attribution license="cc4" from="Microsoft" modified="false" />
736           <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
737         </remarks>
738         <summary>
739           <attribution license="cc4" from="Microsoft" modified="false" />
740           <para>Determines whether the specified year in the specified era is a leap year.</para>
741         </summary>
742         <returns>
743           <attribution license="cc4" from="Microsoft" modified="false" />
744           <para>true if the specified year is a leap year; otherwise, false.</para>
745         </returns>
746         <param name="year">
747           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
748         <param name="era">
749           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
750       </Docs>
751     </Member>
752     <Member MemberName="MaxSupportedDateTime">
753       <MemberSignature Language="C#" Value="public override DateTime MaxSupportedDateTime { get; }" />
754       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.DateTime MaxSupportedDateTime" />
755       <MemberType>Property</MemberType>
756       <AssemblyInfo>
757         <AssemblyVersion>2.0.0.0</AssemblyVersion>
758         <AssemblyVersion>4.0.0.0</AssemblyVersion>
759       </AssemblyInfo>
760       <Attributes>
761         <Attribute>
762           <AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
763         </Attribute>
764       </Attributes>
765       <ReturnValue>
766         <ReturnType>System.DateTime</ReturnType>
767       </ReturnValue>
768       <Docs>
769         <value>To be added.</value>
770         <remarks>To be added.</remarks>
771         <since version=".NET 2.0" />
772         <summary>
773           <attribution license="cc4" from="Microsoft" modified="false" />
774           <para>Gets the latest date and time supported by the <see cref="T:System.Globalization.GregorianCalendar" /> type.</para>
775         </summary>
776       </Docs>
777     </Member>
778     <Member MemberName="MinSupportedDateTime">
779       <MemberSignature Language="C#" Value="public override DateTime MinSupportedDateTime { get; }" />
780       <MemberSignature Language="ILAsm" Value=".property instance valuetype System.DateTime MinSupportedDateTime" />
781       <MemberType>Property</MemberType>
782       <AssemblyInfo>
783         <AssemblyVersion>2.0.0.0</AssemblyVersion>
784         <AssemblyVersion>4.0.0.0</AssemblyVersion>
785       </AssemblyInfo>
786       <Attributes>
787         <Attribute>
788           <AttributeName>System.Runtime.InteropServices.ComVisible(false)</AttributeName>
789         </Attribute>
790       </Attributes>
791       <ReturnValue>
792         <ReturnType>System.DateTime</ReturnType>
793       </ReturnValue>
794       <Docs>
795         <value>To be added.</value>
796         <since version=".NET 2.0" />
797         <remarks>
798           <attribution license="cc4" from="Microsoft" modified="false" />
799           <para>Although the value of the <see cref="P:System.Globalization.GregorianCalendar.MinSupportedDateTime" /> property is the first moment of January 1, 0001 C.E., the Gregorian calendar was not introduced until October 15, 1582, and its adoption throughout the European continent and worldwide was slow. Until they adopted the Gregorian calendar, most cultures in the European, American, and Australian continents used the Julian calendar, which is represented by the <see cref="T:System.Globalization.JulianCalendar" /> class. </para>
800         </remarks>
801         <summary>
802           <attribution license="cc4" from="Microsoft" modified="false" />
803           <para>Gets the earliest date and time supported by the <see cref="T:System.Globalization.GregorianCalendar" /> type.</para>
804         </summary>
805       </Docs>
806     </Member>
807     <Member MemberName="ToDateTime">
808       <MemberSignature Language="C#" Value="public override DateTime ToDateTime (int year, int month, int day, int hour, int minute, int second, int millisecond, int era);" />
809       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance valuetype System.DateTime ToDateTime(int32 year, int32 month, int32 day, int32 hour, int32 minute, int32 second, int32 millisecond, int32 era) cil managed" />
810       <MemberType>Method</MemberType>
811       <AssemblyInfo>
812         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
813         <AssemblyVersion>2.0.0.0</AssemblyVersion>
814         <AssemblyVersion>4.0.0.0</AssemblyVersion>
815       </AssemblyInfo>
816       <ReturnValue>
817         <ReturnType>System.DateTime</ReturnType>
818       </ReturnValue>
819       <Parameters>
820         <Parameter Name="year" Type="System.Int32" />
821         <Parameter Name="month" Type="System.Int32" />
822         <Parameter Name="day" Type="System.Int32" />
823         <Parameter Name="hour" Type="System.Int32" />
824         <Parameter Name="minute" Type="System.Int32" />
825         <Parameter Name="second" Type="System.Int32" />
826         <Parameter Name="millisecond" Type="System.Int32" />
827         <Parameter Name="era" Type="System.Int32" />
828       </Parameters>
829       <Docs>
830         <remarks>To be added.</remarks>
831         <summary>
832           <attribution license="cc4" from="Microsoft" modified="false" />
833           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
834         </summary>
835         <returns>
836           <attribution license="cc4" from="Microsoft" modified="false" />
837           <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
838         </returns>
839         <param name="year">
840           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
841         <param name="month">
842           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 to 12 that represents the month. </param>
843         <param name="day">
844           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 to 31 that represents the day. </param>
845         <param name="hour">
846           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 0 to 23 that represents the hour. </param>
847         <param name="minute">
848           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 0 to 59 that represents the minute. </param>
849         <param name="second">
850           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 0 to 59 that represents the second. </param>
851         <param name="millisecond">
852           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 0 to 999 that represents the millisecond. </param>
853         <param name="era">
854           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the era. </param>
855       </Docs>
856     </Member>
857     <Member MemberName="ToFourDigitYear">
858       <MemberSignature Language="C#" Value="public override int ToFourDigitYear (int year);" />
859       <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance int32 ToFourDigitYear(int32 year) cil managed" />
860       <MemberType>Method</MemberType>
861       <AssemblyInfo>
862         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
863         <AssemblyVersion>2.0.0.0</AssemblyVersion>
864         <AssemblyVersion>4.0.0.0</AssemblyVersion>
865       </AssemblyInfo>
866       <ReturnValue>
867         <ReturnType>System.Int32</ReturnType>
868       </ReturnValue>
869       <Parameters>
870         <Parameter Name="year" Type="System.Int32" />
871       </Parameters>
872       <Docs>
873         <remarks>
874           <attribution license="cc4" from="Microsoft" modified="false" />
875           <para>
876             <see cref="P:System.Globalization.GregorianCalendar.TwoDigitYearMax" /> is the last year in the 100-year range that can be represented by a two-digit year. The century is determined by finding the sole occurrence of the two-digit <paramref name="year" /> within that 100-year range. For example, if <see cref="P:System.Globalization.GregorianCalendar.TwoDigitYearMax" /> is set to 2029, the 100-year range is from 1930 to 2029. Therefore, a 2-digit value of 30 is interpreted as 1930, while a 2-digit value of 29 is interpreted as 2029.</para>
877           <para>
878             <see cref="M:System.Globalization.GregorianCalendar.ToFourDigitYear(System.Int32)" /> supports either a two-digit year or a four-digit year. Passing a two-digit year value (less than 100) causes the method to convert the value to a four-digit value according to the <see cref="P:System.Globalization.GregorianCalendar.TwoDigitYearMax" /> value representing the appropriate century. If the application supplies a four-digit year value that is within the supported calendar range to <see cref="M:System.Globalization.GregorianCalendar.ToFourDigitYear(System.Int32)" />, the method returns the actual input value. If the application supplies a four-digit value that is outside the supported calendar range, or if it supplies a negative value, the method throws an exception.</para>
879         </remarks>
880         <summary>
881           <attribution license="cc4" from="Microsoft" modified="false" />
882           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.GregorianCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
883         </summary>
884         <returns>
885           <attribution license="cc4" from="Microsoft" modified="false" />
886           <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
887         </returns>
888         <param name="year">
889           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
890       </Docs>
891     </Member>
892     <Member MemberName="TwoDigitYearMax">
893       <MemberSignature Language="C#" Value="public override int TwoDigitYearMax { get; set; }" />
894       <MemberSignature Language="ILAsm" Value=".property instance int32 TwoDigitYearMax" />
895       <MemberType>Property</MemberType>
896       <AssemblyInfo>
897         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
898         <AssemblyVersion>2.0.0.0</AssemblyVersion>
899         <AssemblyVersion>4.0.0.0</AssemblyVersion>
900       </AssemblyInfo>
901       <ReturnValue>
902         <ReturnType>System.Int32</ReturnType>
903       </ReturnValue>
904       <Docs>
905         <value>To be added.</value>
906         <remarks>
907           <attribution license="cc4" from="Microsoft" modified="false" />
908           <para>This property allows a 2-digit year to be properly translated to a 4-digit year. For example, if this property is set to 2029, the 100-year range is from 1930 to 2029. Therefore, a 2-digit value of 30 is interpreted as 1930, while a 2-digit value of 29 is interpreted as 2029.</para>
909           <para>The initial value of this property is derived from the settings in the regional and language options portion of Control Panel. However, that information can change during the life of the <see cref="T:System.AppDomain" />. The <see cref="T:System.Globalization.GregorianCalendar" /> class does not detect changes in the system settings automatically.</para>
910           <para>The application should set this value to 99 to indicate that 2-digit years are to be taken literally. For example, if this property is set to 99, the 100-year range is from 0 (not a valid value for most calendars) to 99. Therefore, a 2-digit value of 30 is interpreted as 30.</para>
911         </remarks>
912         <summary>
913           <attribution license="cc4" from="Microsoft" modified="false" />
914           <para>Gets or sets the last year of a 100-year range that can be represented by a 2-digit year.</para>
915         </summary>
916       </Docs>
917     </Member>
918   </Members>
919 </Type>