Export (0) Print
Expand All

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
)
public static String ToString (
	DateTime value
)
public static function ToString (
	value : DateTime
) : String
Not applicable.

Parameters

value

A DateTime.

Return Value

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 DateTimeIFormatProviderDemo
{
    static void DisplayDateNCultureName( 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.
        Console.WriteLine("   {0,-12}{1}", 
            String.Concat( "[", cultureName, "]" ), dateString );
    }

    static void Main( )
    {
        // Specify the date to be formatted under various cultures.
        DateTime tDate = new DateTime( 2003, 4, 15, 20, 30, 40, 333 );

        Console.WriteLine( "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" );

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

        // Format the date with IFormatProvider for several cultures.
        Console.WriteLine( "   {0,-12}{1}", 
            "Culture", "With IFormatProvider" );
        Console.WriteLine( "   {0,-12}{1}", 
            "-------", "--------------------" );
        
        DisplayDateNCultureName( tDate, "" );
        DisplayDateNCultureName( tDate, "en-US" );
        DisplayDateNCultureName( tDate, "es-AR" );
        DisplayDateNCultureName( tDate, "fr-FR" );
        DisplayDateNCultureName( tDate, "hi-IN" );
        DisplayDateNCultureName( tDate, "ja-JP" );
        DisplayDateNCultureName( tDate, "nl-NL" );
        DisplayDateNCultureName( tDate, "ru-RU" );
        DisplayDateNCultureName( 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
*/ 

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

class DateTimeIFormatProviderDemo
{   
    static void DisplayDateNCultureName(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.
        Console.WriteLine("   {0,-12}{1}", String.Concat("[", cultureName, "]"), 
            dateString);
    } //DisplayDateNCultureName   
   
    public static void main(String[] args)
    {
   
        // Specify the date to be formatted under various cultures.
        DateTime tDate =  new DateTime(2003, 4, 15, 20, 30, 40, 333);
      
        Console.WriteLine(("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"));
      
        // Format the date without an IFormatProvider.
        Console.WriteLine("   {0,-12}{1}", null, "No IFormatProvider");
        Console.WriteLine("   {0,-12}{1}", null, "------------------");
        Console.WriteLine("   {0,-12}{1}\n", String.Concat("[", 
            CultureInfo.get_CurrentCulture().get_Name(), "]"), 
            Convert.ToString(tDate));
      
        // Format the date with IFormatProvider for several cultures.
        Console.WriteLine("   {0,-12}{1}", "Culture", "With IFormatProvider");
        Console.WriteLine("   {0,-12}{1}", "-------", "--------------------");
      
        DisplayDateNCultureName(tDate, "");
        DisplayDateNCultureName(tDate, "en-US");
        DisplayDateNCultureName(tDate, "es-AR");
        DisplayDateNCultureName(tDate, "fr-FR");
        DisplayDateNCultureName(tDate, "hi-IN");
        DisplayDateNCultureName(tDate, "ja-JP");
        DisplayDateNCultureName(tDate, "nl-NL");
        DisplayDateNCultureName(tDate, "ru-RU");
        DisplayDateNCultureName(tDate, "ur-PK");
    } //main
} //DateTimeIFormatProviderDemo

/*
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 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show:
© 2014 Microsoft