TaiwanCalendar.MinSupportedDateTime Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets the earliest date and time supported by the TaiwanCalendar class.

Namespace:  System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

Syntax

Public Overrides ReadOnly Property MinSupportedDateTime As DateTime
public override DateTime MinSupportedDateTime { get; }

Property Value

Type: System..::.DateTime
The earliest date and time supported by the TaiwanCalendar class, which is equivalent to the first moment of January 1, 1912 C.E. in the Gregorian calendar.

Remarks

Microsoft Visual Basic represents time of day as the specified time on the minimum date supported by DateTime, which is January 1, 0001 C.E. However, the TaiwanCalendar class does not support that minimum date. Consequently, if your application calls a method to format the time of day using the current calendar but does not specify a format specifier, formatting uses the ISO 8601 sortable ("s") date/time pattern format specifier instead of the default general ("G") date/time pattern format specifier.

Examples

The following code example gets the minimum value and the maximum value of the calendar.

Imports System.Globalization

Public Class Example

   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      ' Create an instance of the calendar.
      Dim myCal As New TaiwanCalendar()
      outputBlock.Text &= myCal.ToString() & vbCrLf

      ' Create an instance of the GregorianCalendar.
      Dim myGre As New GregorianCalendar()

      ' Display the MinSupportedDateTime and its equivalent in the GregorianCalendar.
      Dim myMin As DateTime = myCal.MinSupportedDateTime
      outputBlock.Text += String.Format("MinSupportedDateTime: {0:D2}/{1:D2}/{2:D4}", myCal.GetMonth(myMin), myCal.GetDayOfMonth(myMin), myCal.GetYear(myMin))
      outputBlock.Text += String.Format(" (in Gregorian, {0:D2}/{1:D2}/{2:D4})", myGre.GetMonth(myMin), myGre.GetDayOfMonth(myMin), myGre.GetYear(myMin)) & vbCrLf

      ' Display the MaxSupportedDateTime and its equivalent in the GregorianCalendar.
      Dim myMax As DateTime = myCal.MaxSupportedDateTime
      outputBlock.Text += String.Format("MaxSupportedDateTime: {0:D2}/{1:D2}/{2:D4}", myCal.GetMonth(myMax), myCal.GetDayOfMonth(myMax), myCal.GetYear(myMax))
      outputBlock.Text += String.Format(" (in Gregorian, {0:D2}/{1:D2}/{2:D4})", myGre.GetMonth(myMax), myGre.GetDayOfMonth(myMax), myGre.GetYear(myMax)) & vbCrLf

   End Sub 'Main 

End Class 'SamplesCalendar


'This code produces the following output.
'
'System.Globalization.TaiwanCalendar
'MinSupportedDateTime: 01/01/0001 (in Gregorian, 01/01/1912)
'MaxSupportedDateTime: 12/31/8088 (in Gregorian, 12/31/9999)

using System;
using System.Globalization;


public class Example
{

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {

      // Create an instance of the calendar.
      TaiwanCalendar myCal = new TaiwanCalendar();
      outputBlock.Text += myCal.ToString() + "\n";

      // Create an instance of the GregorianCalendar.
      GregorianCalendar myGre = new GregorianCalendar();

      // Display the MinValue and its equivalent in the GregorianCalendar.
      DateTime myMin = myCal.MinSupportedDateTime;
      outputBlock.Text += String.Format("MinSupportedDateTime: {0:D2}/{1:D2}/{2:D4}", myCal.GetMonth(myMin), myCal.GetDayOfMonth(myMin), myCal.GetYear(myMin));
      outputBlock.Text += String.Format(" (in Gregorian, {0:D2}/{1:D2}/{2:D4})", myGre.GetMonth(myMin), myGre.GetDayOfMonth(myMin), myGre.GetYear(myMin)) + "\n";

      // Display the MaxValue and its equivalent in the GregorianCalendar.
      DateTime myMax = myCal.MaxSupportedDateTime;
      outputBlock.Text += String.Format("MaxSupportedDateTime: {0:D2}/{1:D2}/{2:D4}", myCal.GetMonth(myMax), myCal.GetDayOfMonth(myMax), myCal.GetYear(myMax));
      outputBlock.Text += String.Format(" (in Gregorian, {0:D2}/{1:D2}/{2:D4})", myGre.GetMonth(myMax), myGre.GetDayOfMonth(myMax), myGre.GetYear(myMax)) + "\n";

   }

}


/*
This code produces the following output.

System.Globalization.TaiwanCalendar
MinSupportedDateTime: 01/01/0001 (in Gregorian, 01/01/1912)
MaxSupportedDateTime: 12/31/8088 (in Gregorian, 12/31/9999)

*/

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.0

Platforms

Windows Phone

See Also

Reference

TaiwanCalendar Class

System.Globalization Namespace