Convert.ToString Method (DateTime, IFormatProvider)

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

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.

' Example of the Convert.ToString( DateTime ) and 
' Convert.ToString( DateTime, IFormatProvider ) methods.
Imports System.Globalization
Module Example
 Sub DisplayDateNCultureName(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal testDate As DateTime, _
 ByVal cultureName As String)
 ' Create the CultureInfo object for the specified culture,
 ' and use it as the IFormatProvider when converting the date.
 Dim culture As CultureInfo = New CultureInfo(cultureName)
 Dim dateString As String = _
 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) & vbCrLf
 End Sub
 Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
 ' Specify the date to be formatted under various cultures.
 Dim tDate As DateTime = _
 New DateTime(2003, 4, 15, 20, 30, 40, 333)
 outputBlock.Text &= String.Format("This example of " & vbCrLf & _
 " Convert.ToString( DateTime ) and " & vbCrLf & _
 " Convert.ToString( DateTime, IFormatProvider )" & _
 vbCrLf & "generates the following output. It " & _
 "creates CultureInfo objects " & vbCrLf & "for " & _
 "several cultures and formats " & _
 "a DateTime value with each." & vbCrLf) & vbCrLf
 ' Format the date without an IFormatProvider.
 outputBlock.Text &= String.Format(" {0,-12}{1}", _
 Nothing, "No IFormatProvider") & vbCrLf
 outputBlock.Text &= String.Format(" {0,-12}{1}", _
 Nothing, "------------------") & vbCrLf
 outputBlock.Text &= String.Format(" {0,-12}{1}" & vbCrLf, _
 String.Concat( _
 "[", CultureInfo.CurrentCulture.Name, "]"), _
 Convert.ToString(tDate)) & vbCrLf
 ' Format the date with IFormatProvider for several cultures.
 outputBlock.Text &= String.Format(" {0,-12}{1}", _
 "Culture", "With IFormatProvider") & vbCrLf
 outputBlock.Text &= String.Format(" {0,-12}{1}", _
 "-------", "--------------------") & vbCrLf
 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")
 End Sub
End Module
' 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

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

Convert Class

ToString Overload

System Namespace