Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Convert.ToString Method (DateTime)

Converts the value of the specified DateTime to its equivalent String representation.

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

public static string ToString(
	DateTime value
)

Parameters

value
Type: System.DateTime
A DateTime.

Return Value

Type: System.String
The String equivalent of the value of value.

This implementation is identical to DateTime.ToString.

The following code example converts a DateTime value to a String with the ToString method, using default formatting.


// Example of the Convert.ToString( DateTime ) and 
// Convert.ToString( DateTime, IFormatProvider ) methods.
using System;
using System.Globalization;

class Example
{
   static void DisplayDateNCultureName(System.Windows.Controls.TextBlock outputBlock, DateTime testDate,
       string cultureName)
   {
      // Create the CultureInfo object for the specified culture,
      // and use it as the IFormatProvider when converting the date.
      CultureInfo culture = new CultureInfo(cultureName);
      string dateString = Convert.ToString(testDate, culture);

      // Bracket the culture name, and display the name and date.
      outputBlock.Text += String.Format("   {0,-12}{1}",
          String.Concat("[", cultureName, "]"), dateString) + "\n";
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      // Specify the date to be formatted under various cultures.
      DateTime tDate = new DateTime(2003, 4, 15, 20, 30, 40, 333);

      outputBlock.Text += String.Format("This example of \n" +
          "   Convert.ToString( DateTime ) and \n" +
          "   Convert.ToString( DateTime, IFormatProvider )\n" +
          "generates the following output. It creates " +
          "CultureInfo objects \nfor several cultures " +
          "and formats a DateTime value with each.\n") + "\n";

      // Format the date without an IFormatProvider.
      outputBlock.Text += String.Format("   {0,-12}{1}",
          null, "No IFormatProvider") + "\n";
      outputBlock.Text += String.Format("   {0,-12}{1}",
          null, "------------------") + "\n";
      outputBlock.Text += String.Format("   {0,-12}{1}\n",
          String.Concat("[", CultureInfo.CurrentCulture.Name, "]"),
          Convert.ToString(tDate)) + "\n";

      // Format the date with IFormatProvider for several cultures.
      outputBlock.Text += String.Format("   {0,-12}{1}",
          "Culture", "With IFormatProvider") + "\n";
      outputBlock.Text += String.Format("   {0,-12}{1}",
          "-------", "--------------------") + "\n";

      DisplayDateNCultureName(outputBlock, tDate, "");
      DisplayDateNCultureName(outputBlock, tDate, "en-US");
      DisplayDateNCultureName(outputBlock, tDate, "es-AR");
      DisplayDateNCultureName(outputBlock, tDate, "fr-FR");
      DisplayDateNCultureName(outputBlock, tDate, "hi-IN");
      DisplayDateNCultureName(outputBlock, tDate, "ja-JP");
      DisplayDateNCultureName(outputBlock, tDate, "nl-NL");
      DisplayDateNCultureName(outputBlock, tDate, "ru-RU");
      DisplayDateNCultureName(outputBlock, tDate, "ur-PK");
   }
}

/*
This example of
   Convert.ToString( DateTime ) and
   Convert.ToString( DateTime, IFormatProvider )
generates the following output. It creates CultureInfo objects
for several cultures and formats a DateTime value with each.

               No IFormatProvider
               ------------------
   [en-US]     4/15/2003 8:30:40 PM

   Culture     With IFormatProvider
   -------     --------------------
   []          04/15/2003 20:30:40
   [en-US]     4/15/2003 8:30:40 PM
   [es-AR]     15/04/2003 08:30:40 p.m.
   [fr-FR]     15/04/2003 20:30:40
   [hi-IN]     15-04-2003 20:30:40
   [ja-JP]     2003/04/15 20:30:40
   [nl-NL]     15-4-2003 20:30:40
   [ru-RU]     15.04.2003 20:30:40
   [ur-PK]     15/04/2003 8:30:40 PM
*/


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

Show:
© 2014 Microsoft