DateTimeFormatInfo.SetAllDateTimePatterns(String[], Char) Methode

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

DateTimeFormatInfo.cs

Legt die benutzerdefinierten Formatzeichenfolgen für Datum und Uhrzeit fest, die einer angegebenen Standardformatzeichenfolge entsprechen.

public:
 void SetAllDateTimePatterns(cli::array <System::String ^> ^ patterns, char format);

public void SetAllDateTimePatterns (string[] patterns, char format);

member this.SetAllDateTimePatterns : string[] * char -> unit

Public Sub SetAllDateTimePatterns (patterns As String(), format As Char)

Parameter

patterns

String[]

Ein Array benutzerdefinierter Formatzeichenfolgen.

format

Char

Die den im patterns-Parameter angegebenen benutzerdefinierten Formatzeichenfolgen zugeordnete Standardformatzeichenfolge.

Ausnahmen

ArgumentException

patterns ist null oder ein Array der Länge 0 (null).

- oder -

format ist keine gültige Standardformatzeichenfolge oder ist eine Standardformatzeichenfolge, deren Muster nicht festgelegt werden können.

ArgumentNullException

patterns hat ein Arrayelement, dessen Wert null ist.

InvalidOperationException

Dieses DateTimeFormatInfo-Objekt ist schreibgeschützt.

Beispiele

Im folgenden Beispiel wird ein CultureInfo -Objekt instanziiert, das die Kultur "en-US" (Englisch – USA) darstellt, und verwendet es, um ein Array von Datums- und Uhrzeitzeichenfolgen mithilfe der Standardformatzeichenfolge "Y" zu analysieren. Anschließend wird die SetAllDateTimePatterns -Methode verwendet, um der Standardformatzeichenfolge "Y" eine neue benutzerdefinierte Formatzeichenfolge zuzuordnen, und versucht dann, das Array der Datums- und Uhrzeitzeichenfolgen zu analysieren. Die Ausgabe des Beispiels zeigt, dass die neue benutzerdefinierte Formatzeichenfolge sowohl in den Analyse- als auch bei formatierungsvorgängen verwendet wird.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Use standard en-US culture.
      CultureInfo enUS = new CultureInfo("en-US");

      string[] values = { "December 2010", "December, 2010",
                          "Dec-2010", "December-2010" };

      Console.WriteLine("Supported Y/y patterns for {0} culture:", enUS.Name);
      foreach (var pattern in enUS.DateTimeFormat.GetAllDateTimePatterns('Y'))
         Console.WriteLine("   " + pattern);

      Console.WriteLine();

      // Try to parse each date string using "Y" format specifier.
      foreach (var value in values) {
         try {
            DateTime dat = DateTime.ParseExact(value, "Y", enUS);
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat));
         }
         catch (FormatException) {
            Console.WriteLine("   Cannot parse {0}", value);
         }
      }
      Console.WriteLine();

      //Modify supported "Y" format.
      enUS.DateTimeFormat.SetAllDateTimePatterns( new string[] { "MMM-yyyy" } , 'Y');

      Console.WriteLine("New supported Y/y patterns for {0} culture:", enUS.Name);
      foreach (var pattern in enUS.DateTimeFormat.GetAllDateTimePatterns('Y'))
         Console.WriteLine("   " + pattern);

      Console.WriteLine();

      // Try to parse each date string using "Y" format specifier.
      foreach (var value in values) {
         try {
            DateTime dat = DateTime.ParseExact(value, "Y", enUS);
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat));
         }
         catch (FormatException) {
            Console.WriteLine("   Cannot parse {0}", value);
         }
      }
   }
}
// The example displays the following output:
//       Supported Y/y patterns for en-US culture:
//          MMMM, yyyy
//
//          Cannot parse December 2010
//          Parsed December, 2010 as December, 2010
//          Cannot parse Dec-2010
//          Cannot parse December-2010
//
//       New supported Y/y patterns for en-US culture:
//          MMM-yyyy
//
//          Cannot parse December 2010
//          Cannot parse December, 2010
//          Parsed Dec-2010 as Dec-2010
//          Cannot parse December-2010

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Use standard en-US culture.
      Dim enUS As New CultureInfo("en-US")
      
      Dim values() As String = { "December 2010", "December, 2010",  
                                 "Dec-2010", "December-2010" } 
      
      Console.WriteLine("Supported Y/y patterns for {0} culture:", enUS.Name)
      For Each pattern In enUS.DateTimeFormat.GetAllDateTimePatterns("Y"c)
         Console.WriteLine("   " + pattern)
      Next 
      Console.WriteLine()
      
      ' Try to parse each date string using "Y" format specifier.
      For Each value In values
         Try
            Dim dat As Date = Date.ParseExact(value, "Y", enUS)
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat))
         Catch e As FormatException
            Console.WriteLine("   Cannot parse {0}", value)
         End Try   
      Next   
      Console.WriteLine()
      
      'Modify supported "Y" format.
      enUS.DateTimeFormat.SetAllDateTimePatterns( { "MMM-yyyy" } , "Y"c)
      
      Console.WriteLine("New supported Y/y patterns for {0} culture:", enUS.Name)
      For Each pattern In enUS.DateTimeFormat.GetAllDateTimePatterns("Y"c)
         Console.WriteLine("   " + pattern)
      Next 
      Console.WriteLine()

      ' Try to parse each date string using "Y" format specifier.
      For Each value In values
         Try
            Dim dat As Date = Date.ParseExact(value, "Y", enUS)
            Console.WriteLine(String.Format(enUS, "   Parsed {0} as {1:Y}", value, dat))
         Catch e As FormatException
            Console.WriteLine("   Cannot parse {0}", value)
         End Try   
      Next   
   End Sub
End Module
' The example displays the following output:
'       Supported Y/y patterns for en-US culture:
'          MMMM, yyyy
'       
'          Cannot parse December 2010
'          Parsed December, 2010 as December, 2010
'          Cannot parse Dec-2010
'          Cannot parse December-2010
'       
'       New supported Y/y patterns for en-US culture:
'          MMM-yyyy
'       
'          Cannot parse December 2010
'          Cannot parse December, 2010
'          Parsed Dec-2010 as Dec-2010
'          Cannot parse December-2010

Hinweise

Die SetAllDateTimePatterns -Methode definiert die benutzerdefinierten Formatzeichenfolgen, die einer bestimmten Standardformatzeichenfolge für Datum und Uhrzeit entsprechen. Wenn ein Aufruf einer Datums- und Uhrzeitformatmethode die von formatangegebene Standardformatzeichenfolge für Datum und Uhrzeit enthält, verwendet die -Methode das erste Element im patterns Array, um das Format der resultierenden Zeichenfolge zu definieren.

Warnung

Die Parse Methoden und TryParse durchlaufen nicht alle Zeichenfolgen in patterns vollständig, wenn die Zeichenfolgendarstellung eines Datums und einer Uhrzeit analysiert wird. Wenn Sie eine Datums- und Uhrzeitzeichenfolge für bestimmte Formate in einem Analysevorgang benötigen, sollten Sie das Array der gültigen Formate an die DateTime.ParseExact(String, String[], IFormatProvider, DateTimeStyles)Methode , DateTimeOffset.ParseExact(String, String[], IFormatProvider, DateTimeStyles), DateTime.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)oder DateTimeOffset.TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset) übergeben.

Sie können benutzerdefinierte Formatzeichenfolgen definieren, die den Standardformatzeichenfolgen "d", "D", "t", "T" und "y" oder "Y" entsprechen. Wenn der Wert von format eine andere Standardformatzeichenfolge ist, löst die SetAllDateTimePatterns -Methode einen aus ArgumentException.

Wenn Ihre benutzerdefinierten Datums- und Uhrzeitformatzeichenfolgen Datumstrennzeichen enthalten, sollten Sie explizit ein Datumstrennzeichen angeben, anstatt sich auf die Analyse- oder Formatierungsmethode zu verlassen, die den benutzerdefinierten Formatbezeichner "/" durch ein bestimmtes Datumstrennzeichen ersetzt. Um beispielsweise das Muster MM-DD-jjjj abzurufen, verwenden Sie das Muster "MM-TT-JJJJ".

Weitere Informationen

• GetAllDateTimePatterns
• Standard-Formatzeichenfolgen für Datum und Uhrzeit
• Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit