Convert.ToString Method (DateTime, IFormatProvider)

July 28, 2014

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,
	IFormatProvider provider
)

Parameters

value
Type: System.DateTime
A DateTime.
provider
Type: System.IFormatProvider
An IFormatProvider interface implementation that supplies culture-specific formatting information.

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 an IFormatProvider object.


// 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
*/


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft