DateTimeFormatInfo.Calendar Proprietà

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Ottiene o imposta il calendario da usare per le impostazioni cultura correnti.

public:
 property System::Globalization::Calendar ^ Calendar { System::Globalization::Calendar ^ get(); void set(System::Globalization::Calendar ^ value); };

public System.Globalization.Calendar Calendar { get; set; }

member this.Calendar : System.Globalization.Calendar with get, set

Public Property Calendar As Calendar

Valore della proprietà

Calendar

Calendario da usare per le impostazioni cultura correnti. L'impostazione predefinita per InvariantInfo è un oggetto GregorianCalendar.

Eccezioni

ArgumentNullException

La proprietà viene impostata su null.

ArgumentOutOfRangeException

La proprietà viene impostata su un oggetto Calendar non valido per le impostazioni cultura correnti.

InvalidOperationException

La proprietà viene impostata e l'oggetto DateTimeFormatInfo è di sola lettura.

Esempio

Nell'esempio seguente viene definito un ChangeCalendar metodo che modifica il calendario corrente di una lingua in un calendario specificato, a meno che non sia già il calendario corrente o se non sia supportato dalle impostazioni cultura. Il codice che chiama il metodo crea un'istanza di un CultureInfo oggetto che rappresenta le impostazioni cultura arabe (Egitto) e tenta innanzitutto di modificare il calendario con il calendario giapponese. Poiché il calendario giapponese non è supportato, il metodo non modifica il calendario delle impostazioni cultura. Tuttavia, poiché il calendario al-Qura di messaggistica unificata è un membro della CultureInfo.OptionalCalendars raccolta, il metodo riesce a renderlo il calendario corrente per le impostazioni cultura ar-EG.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo ci = CultureInfo.CreateSpecificCulture("ar-EG");
      Console.WriteLine("The current calendar for the {0} culture is {1}",
                        ci.Name,
                        CalendarUtilities.ShowCalendarName(ci.DateTimeFormat.Calendar));

      CalendarUtilities.ChangeCalendar(ci, new JapaneseCalendar());
      Console.WriteLine("The current calendar for the {0} culture is {1}",
                        ci.Name,
                        CalendarUtilities.ShowCalendarName(ci.DateTimeFormat.Calendar));

      CalendarUtilities.ChangeCalendar(ci, new UmAlQuraCalendar());
      Console.WriteLine("The current calendar for the {0} culture is {1}",
                        ci.Name,
                        CalendarUtilities.ShowCalendarName(ci.DateTimeFormat.Calendar));
   }
}

public class CalendarUtilities
{
   private Calendar newCal;
   private bool isGregorian;

   public static void ChangeCalendar(CultureInfo ci, Calendar cal)
   {
      CalendarUtilities util = new CalendarUtilities(cal);

      // Is the new calendar already the current calendar?
      if (util.CalendarExists(ci.DateTimeFormat.Calendar))
         return;

      // Is the new calendar supported?
      if (Array.Exists(ci.OptionalCalendars, util.CalendarExists))
         ci.DateTimeFormat.Calendar = cal;
   }

   private CalendarUtilities(Calendar cal)
   {
      newCal = cal;

      // Is the new calendar a Gregorian calendar?
      isGregorian = cal.GetType().Name.Contains("Gregorian");
   }

   private bool CalendarExists(Calendar cal)
   {
      if (cal.ToString() == newCal.ToString()) {
         if (isGregorian) {
            if (((GregorianCalendar) cal).CalendarType ==
               ((GregorianCalendar) newCal).CalendarType)
               return true;
         }
         else {
            return true;
         }
      }
      return false;
   }

   public static string ShowCalendarName(Calendar cal)
   {
      string calName = cal.ToString().Replace("System.Globalization.", "");
      if (cal is GregorianCalendar)
         calName += ", Type " + ((GregorianCalendar) cal).CalendarType.ToString();

      return calName;
   }
}
// The example displays the following output:
//    The current calendar for the ar-EG culture is GregorianCalendar, Type Localized
//    The current calendar for the ar-EG culture is GregorianCalendar, Type Localized
//    The current calendar for the ar-EG culture is UmAlQuraCalendar

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim ci As CultureInfo = CultureInfo.CreateSpecificCulture("ar-EG")
      Console.WriteLine("The current calendar for the {0} culture is {1}",
                        ci.Name, 
                        CalendarUtilities.ShowCalendarName(ci.DateTimeFormat.Calendar))

      CalendarUtilities.ChangeCalendar(ci, New JapaneseCalendar())
      Console.WriteLine("The current calendar for the {0} culture is {1}",
                        ci.Name, 
                        CalendarUtilities.ShowCalendarName(ci.DateTimeFormat.Calendar))
      
      CalendarUtilities.ChangeCalendar(ci, New UmAlQuraCalendar())
      Console.WriteLine("The current calendar for the {0} culture is {1}",
                        ci.Name, 
                        CalendarUtilities.ShowCalendarName(ci.DateTimeFormat.Calendar))
   End Sub
End Module

Public Class CalendarUtilities
   Private newCal As Calendar
   Private isGregorian As Boolean
   
   Public Shared Sub ChangeCalendar(ci As CultureInfo, cal As Calendar)
      Dim util As New CalendarUtilities(cal)
      
      ' Is the new calendar already the current calendar?
      If util.CalendarExists(ci.DateTimeFormat.Calendar) Then
         Exit Sub
      End If

      ' Is the new calendar supported?
      If Array.Exists(ci.OptionalCalendars, AddressOf util.CalendarExists) Then
         ci.DateTimeFormat.Calendar = cal
      End If
   End Sub
   
   Private Sub New(cal As Calendar)
      newCal = cal
      
      ' Is the new calendar a Gregorian calendar?
      isGregorian = cal.GetType().Name.Contains("Gregorian")
   End Sub
   
   Private Function CalendarExists(cal As Calendar) As Boolean
      If cal.ToString() = newCal.ToString Then
         If isGregorian Then
            If CType(cal, GregorianCalendar).CalendarType = 
               CType(newCal, GregorianCalendar).CalendarType Then
               Return True
            End If
         Else
            Return True
         End If
      End If
      Return False
   End Function

   Public Shared Function ShowCalendarName(cal As Calendar) As String
      Dim calName As String = cal.ToString().Replace("System.Globalization.", "")
      If TypeOf cal Is GregorianCalendar Then
         calName += ", Type " + CType(cal, GregorianCalendar).CalendarType.ToString()
      End If
      Return calName 
   End Function
End Class
' The example displays the following output:
'    The current calendar for the ar-EG culture is GregorianCalendar, Type Localized
'    The current calendar for the ar-EG culture is GregorianCalendar, Type Localized
'    The current calendar for the ar-EG culture is UmAlQuraCalendar

Commenti

La Calendar proprietà accetta solo calendari validi per le impostazioni cultura associate all'oggetto DateTimeFormatInfo . La CultureInfo.OptionalCalendars proprietà specifica i calendari che possono essere utilizzati da impostazioni cultura specifiche e la CultureInfo.Calendar proprietà specifica il calendario predefinito per le impostazioni cultura.

Importante

Le ere nel calendario giapponese sono basate sul regno dell'imperatore e pertanto è previsto che cambino. Ad esempio, il 1° maggio 2019 contraddistingue l'inizio dell'era Reiwa in JapaneseCalendar e JapaneseLunisolarCalendar. Questo cambio di era interessa tutte le applicazioni che usano questi calendari. Per altre informazioni e per determinare se le applicazioni sono interessate, vedere Gestione di una nuova era nel calendario giapponese in .NET. Per informazioni sul test delle applicazioni nei sistemi Windows per garantire la conformità per il cambiamento dell'era, vedere Preparare l'applicazione per la modifica dell'era giapponese. Per le funzionalità di .NET che supportano calendari con più era e per le procedure consigliate quando si usano calendari che supportano più ere, vedere Uso delle era.

La modifica del valore di questa proprietà influisce anche sulle proprietà seguenti: MonthNames, , DayNamesAbbreviatedMonthNames, AbbreviatedDayNames, CalendarWeekRule, FirstDayOfWeek, FullDateTimePatternLongDatePatternShortDatePattern, YearMonthPattern, e .MonthDayPattern

Ad esempio, se le impostazioni cultura del thread corrente sono giapponesi, questa proprietà accetta JapaneseCalendar, LocalizedGregorianCalendaro USEnglishGregorianCalendar. JapaneseCalendar Quando viene usato , l'identificatore di data estesa predefinito è "gg y'\x5e74'M'\x6708'd'\x65e5'". Quando viene usato , l'identificatore LocalizedGregorianCalendardi data estesa predefinito è "yyyy'\x5e74'M'\x6708'd'\x65e5'".

Vedi anche

• Calendar