(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DateTime.ToString-Methode (String)

Konvertiert den Wert des aktuellen DateTime-Objekts mit dem angegebenen Format in die entsprechende Zeichenfolgendarstellung.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
public string ToString(
	string format
)

Parameter

format
Typ: System.String
Eine standardmäßige oder benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit (siehe Hinweise).

Rückgabewert

Typ: System.String
Die Zeichenfolgendarstellung des Werts des aktuellen DateTime-Objekts entsprechend der Angabe in format.
AusnahmeBedingung
FormatException

Die Länge von format ist 1, aber es ist keines der für DateTimeFormatInfo definierten Zeichen für Formatbezeichner.

- oder -

format enthält kein gültiges benutzerdefiniertes Formatmuster.

ArgumentOutOfRangeException

Datum und Uhrzeit liegen außerhalb der Bereiche, die vom Kalender der aktuellen Kultur unterstützt werden.

Der format-Parameter sollte entweder einen einzelnen Formatbezeichner (siehe Standard-Formatzeichenfolgen für Datum und Uhrzeit) oder ein benutzerdefiniertes Formatmuster (siehe Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit) enthalten, das das Format der zurückgegeben Zeichenfolge definiert. Wenn format den Wert null hat oder eine leere Zeichenfolge ist, wird der allgemeine Formatbezeichner 'G' verwendet.

Diese Methode verwendet aus der aktuellen Kultur abgeleitete Formatierungsinformationen. Weitere Informationen finden Sie unter CurrentCulture.

Hinweise zu Aufrufern

Die ToString(String)-Methode gibt die Zeichenfolgendarstellung des Datums und der Uhrzeit in dem Kalender zurück, der von der aktuellen Kultur verwendet wird. Wenn der Wert der aktuellen DateTime-Instanz früher als Calendar.MinSupportedDateTime oder später als Calendar.MaxSupportedDateTime ist, löst die Methode eine ArgumentOutOfRangeException aus. Dies wird im folgenden Beispiel veranschaulicht. Es wird versucht, ein Datum zu formatieren, das außerhalb des Bereichs der HebrewCalendar-Klasse ist, 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 werden die einzelnen Standardformatzeichenfolgen für Datum und Uhrzeit und eine Auswahl von benutzerdefinierten Formatzeichenfolgen für Datum und Uhrzeit verwendet, um die Zeichenfolgendarstellung eines DateTime-Werts anzuzeigen. 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


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.