Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DateTime.ToString-Methode: (String)

 

Veröffentlicht: Oktober 2016

Konvertiert den Wert des aktuellen DateTime-Objekts unter Verwendung des angegebenen Formats und der Formatierungskonventionen der aktuellen Kultur in die entsprechende Zeichenfolgendarstellung.

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

public string ToString(
	string format
)

Parameter

format
Type: System.String

Eine standardmäßige Formatzeichenfolge für Datum und Uhrzeit (siehe Hinweise).

Rückgabewert

Type: System.String

Die Zeichenfolgendarstellung des Werts des aktuellen DateTime-Objekts entsprechend der Angabe in format.

Exception Condition
FormatException

Die Länge des format ist 1, und es ist keines der Formatbezeichnerzeichen, die für DateTimeFormatInfo definiert sind.

- oder -

format enthält kein gültiges benutzerdefiniertes Formatmuster.

ArgumentOutOfRangeException

Datum und Uhrzeit liegen außerhalb des Bereichs von Datumsangaben, die von dem Kalender unterstützt werden, der von der aktuellen Kultur verwendet wird.

Die ToString(String) Methode gibt eine Zeichenfolgendarstellung von Datums-und Uhrzeit in einem bestimmten Format, das die Formatierungskonventionen der aktuellen Kultur; Weitere Informationen verwendet, finden Sie unter CultureInfo.CurrentCulture.

Die format -Parameter sollte entweder einen einzelnen Formatbezeichner enthalten (finden Sie unter Standard-Formatzeichenfolgen für Datum und Uhrzeit) oder ein benutzerdefiniertes Formatmuster (finden Sie unter Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit), die das Format der zurückgegebenen Zeichenfolge definiert. Wenn format ist null oder eine leere Zeichenfolge ist, der allgemeine Formatbezeichner "G" verwendet wird.

Einige Verwendungsmöglichkeiten dieser Methode aufgeführt:

  • Abrufen einer Zeichenfolge mit zeigt das Datum und die Uhrzeit in der aktuellen Kultur kurzes Datum und Uhrzeit-Format. Zu diesem Zweck verwenden Sie die Formatbezeichner "G".

  • Erste einer Zeichenfolge, enthält nur den Monat und Jahr. Zu diesem Zweck verwenden Sie die Formatzeichenfolge "MM/Yyyy". Die Formatzeichenfolge wird Datumstrennzeichen für die aktuelle Kultur verwendet.

  • Erste einer Zeichenfolge, enthält das Datum und die Uhrzeit in einem bestimmten Format. Angenommen, die "MM/TT/YyyyHH:mm" Formatzeichenfolge zeigt die Datums- und Uhrzeitzeichenfolge in ein festes Format wie z. B. "19 / / 03 / / 2013 18:06". Verwendet die Formatzeichenfolge "/" als Trennzeichen festgelegte Datum unabhängig von kulturspezifischen Einstellungen.

  • Abrufen von einem Datum in einem komprimierten Format mit konnte für die Serialisierung einer Datumszeichenfolge verwendet werden. Die Formatzeichenfolge "JJJJMMTT" zeigt z. B. eine vierstellige Jahresangabe, gefolgt von einem zweistellige Monatsangabe und eine zweistellige Tagesangabe mit keine Trennzeichen für Datumsangaben.

Im folgenden Beispiel wird diese drei Formatzeichenfolgen, um einen Datums- und Uhrzeitwert mit den Konventionen der Kulturen En-US "und" fr-FR anzuzeigen.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      String[] formats = { "G", "MM/yyyy", @"MM\/dd\/yyyy HH:mm",
                           "yyyyMMdd" };
      String[] cultureNames = { "en-US", "fr-FR" };
      DateTime date = new DateTime(2015, 8, 18, 13, 31, 17);
      foreach (var cultureName in cultureNames) {
         var culture = new CultureInfo(cultureName);
         CultureInfo.CurrentCulture = culture;
         Console.WriteLine(culture.NativeName);
         foreach (var format in formats)
            Console.WriteLine("   {0}: {1}", format,
                              date.ToString(format));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       English (United States)
//          G: 8/18/2015 1:31:17 PM
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818
//
//       français (France)
//          G: 18/08/2015 13:31:17
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818

Hinweise für Aufrufer:

Die ToString(String) Methode gibt eine Zeichenfolgendarstellung von Datum und Uhrzeit zurück, wie sie im Kalender der aktuellen Kultur verwendet wird. Wenn der Wert des aktuellen DateTime Instanz liegt vor Calendar.MinSupportedDateTime oder später als Calendar.MaxSupportedDateTime, löst die Methode eine ArgumentOutOfRangeException. Dies wird im folgenden Beispiel veranschaulicht. Er versucht, ein Datum zu formatieren, die außerhalb des Bereichs der der HebrewCalendar Klasse, wenn die aktuelle Kultur Hebräisch (Israel) ist.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(1550, 7, 21);
      CultureInfo dft;
      CultureInfo heIL = new CultureInfo("he-IL");
      heIL.DateTimeFormat.Calendar = new HebrewCalendar();

      // Change current culture to he-IL.
      dft = Thread.CurrentThread.CurrentCulture;
      Thread.CurrentThread.CurrentCulture = heIL;

      // Display the date using the current culture's calendar.            
      try {
         Console.WriteLine(date1.ToString("G"));
      }   
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0} is earlier than {1} or later than {2}", 
                           date1.ToString("d", CultureInfo.InvariantCulture), 
                           heIL.DateTimeFormat.Calendar.MinSupportedDateTime.ToString("d", CultureInfo.InvariantCulture),  
                           heIL.DateTimeFormat.Calendar.MaxSupportedDateTime.ToString("d", CultureInfo.InvariantCulture)); 
      }

      // Restore the default culture.
      Thread.CurrentThread.CurrentCulture = dft;
   }
}
// The example displays the following output:
//    07/21/1550 is earlier than 01/01/1583 or later than 09/29/2239

Im folgenden Beispiel wird jeder von den Standardformatbezeichnern für Datum und Uhrzeit-Formatzeichenfolgen und eine Auswahl von benutzerdefinierten Formatbezeichner für Datum und Uhrzeit-Formatzeichenfolgen anzuzeigenden die angegebene Zeichenfolgendarstellung einer DateTime Wert. Die aktuelle Threadkultur für das Beispiel ist En-US.

using System;

public class DateToStringExample
{
   public static void Main()
   {
      DateTime dateValue = new DateTime(2008, 6, 15, 21, 15, 07);
      // Create an array of standard format strings.
      string[] standardFmts = {"d", "D", "f", "F", "g", "G", "m", "o", 
                               "R", "s", "t", "T", "u", "U", "y"};
      // Output date and time using each standard format string.
      foreach (string standardFmt in standardFmts)
         Console.WriteLine("{0}: {1}", standardFmt, 
                           dateValue.ToString(standardFmt));
      Console.WriteLine();

      // Create an array of some custom format strings.
      string[] customFmts = {"h:mm:ss.ff t", "d MMM yyyy", "HH:mm:ss.f", 
                             "dd MMM HH:mm:ss", @"\Mon\t\h\: M", "HH:mm:ss.ffffzzz" };
      // Output date and time using each custom format string.
      foreach (string customFmt in customFmts)
         Console.WriteLine("'{0}': {1}", customFmt,
                           dateValue.ToString(customFmt));
   }
}
// This example displays the following output to the console:
//       d: 6/15/2008
//       D: Sunday, June 15, 2008
//       f: Sunday, June 15, 2008 9:15 PM
//       F: Sunday, June 15, 2008 9:15:07 PM
//       g: 6/15/2008 9:15 PM
//       G: 6/15/2008 9:15:07 PM
//       m: June 15
//       o: 2008-06-15T21:15:07.0000000
//       R: Sun, 15 Jun 2008 21:15:07 GMT
//       s: 2008-06-15T21:15:07
//       t: 9:15 PM
//       T: 9:15:07 PM
//       u: 2008-06-15 21:15:07Z
//       U: Monday, June 16, 2008 4:15:07 AM
//       y: June, 2008
//       
//       'h:mm:ss.ff t': 9:15:07.00 P
//       'd MMM yyyy': 15 Jun 2008
//       'HH:mm:ss.f': 21:15:07.0
//       'dd MMM HH:mm:ss': 15 Jun 21:15:07
//       '\Mon\t\h\: M': Month: 6
//       'HH:mm:ss.ffffzzz': 21:15:07.0000-07:00

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: