DateTime.ToLongDateString DateTime.ToLongDateString DateTime.ToLongDateString DateTime.ToLongDateString Method

Definizione

Converte il valore dell'oggetto DateTime corrente nell'equivalente rappresentazione di stringa della data estesa.Converts the value of the current DateTime object to its equivalent long date string representation.

public:
 System::String ^ ToLongDateString();
public string ToLongDateString ();
member this.ToLongDateString : unit -> string
Public Function ToLongDateString () As String

Restituisce

Stringa che contiene la rappresentazione di stringa della data estesa dell'oggetto DateTime corrente.A string that contains the long date string representation of the current DateTime object.

Esempi

Nell'esempio seguente viene illustrato ToLongDateString il metodo.The following example demonstrates the ToLongDateString method.

using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
        // Initialize a DateTime object.
        Console.WriteLine("Initialize the DateTime object to May 16, 2001 3:02:15 AM.\n");
        DateTime dateAndTime = new System.DateTime(2001, 5, 16, 3, 2, 15);

        // Display the name of the current culture.
        Console.WriteLine($"Current culture: \"{CultureInfo.CurrentCulture.Name}\"\n");
        var dtfi = CultureInfo.CurrentCulture.DateTimeFormat;

        // Display the long date pattern and string.
        Console.WriteLine($"Long date pattern: \"{dtfi.LongDatePattern}\"");
        Console.WriteLine($"Long date string:  \"{dateAndTime.ToLongDateString()}\"\n");

        // Display the long time pattern and string.
        Console.WriteLine($"Long time pattern: \"{dtfi.LongTimePattern}\"");
        Console.WriteLine($"Long time string:  \"{dateAndTime.ToLongTimeString()}\"\n");

        // Display the short date pattern and string.
        Console.WriteLine($"Short date pattern: \"{dtfi.ShortDatePattern}\"");
        Console.WriteLine($"Short date string:  \"{dateAndTime.ToShortDateString()}\"\n");

        // Display the short time pattern and string.
        Console.WriteLine($"Short time pattern: \"{dtfi.ShortTimePattern}\"");
        Console.WriteLine($"Short time string:  \"{dateAndTime.ToShortTimeString()}\"\n");
    }
}
// The example displays output similar to the following:
//        Current culture: "en-US"
//
//        Long date pattern: "dddd, MMMM d, yyyy"
//        Long date string:  "Wednesday, May 16, 2001"
//
//        Long time pattern: "h:mm:ss tt"
//        Long time string:  "3:02:15 AM"
//
//        Short date pattern: "M/d/yyyy"
//        Short date string:  "5/16/2001"
//
//        Short time pattern: "h:mm tt"
//        Short time string:  "3:02 AM"
Imports System.Globalization

Module Example
    Public Sub Main() 
        ' Initialize a DateTime object.
        Console.WriteLine($"Initialize the DateTime object to May 16, 2001 3:02:15 AM.{vbCrLf}")
        Dim dateAndTime As New DateTime(2001, 5, 16, 3, 2, 15)
        
        ' Display the name of the current culture.
        Console.WriteLine($"Current culture: ""{CultureInfo.CurrentCulture.Name}""{vbCrLf}")
        Dim dtfi = CultureInfo.CurrentCulture.DateTimeFormat
        
        ' Display the long date pattern and string.
        Console.WriteLine($"Long date pattern: ""{dtfi.LongDatePattern}""")
        Console.WriteLine($"Long date string:  ""{dateAndTime.ToLongDateString()}{vbCrLf}")
        
        ' Display the long time pattern and string.
        Console.WriteLine($"Long time pattern: ""{0}""", dtfi.LongTimePattern)
        Console.WriteLine($"Long time string:  ""{dateAndTime.ToLongTimeString()}{vbCrLf}")
        
        ' Display the short date pattern and string.
        Console.WriteLine($"Short date pattern: ""{dtfi.ShortDatePattern}""")
        Console.WriteLine($"Short date string:  ""{dateAndTime.ToShortDateString()}{vbCrLf}")
        
        ' Display the short time pattern and string.
        Console.WriteLine($"Short time pattern: ""{dtfi.ShortTimePattern}""")
        Console.WriteLine($"Short time string:  ""{dateAndTime.ToShortTimeString()}{vbCrLf}")
    End Sub 'Main
End Module
' The example displays output like the following:
'       Initialize the DateTime object to May 16, 2001 3:02:15 AM.
'
'       Current culture: "en-US"
'
'       Long date pattern: "dddd, MMMM d, yyyy"
'       Long date string:  "Wednesday, May 16, 2001
'
'       Long time pattern: "0"
'       Long time string:  "3:02:15 AM
'
'       Short date pattern: "M/d/yyyy"
'       Short date string:  "5/16/2001
'
'       Short time pattern: "h:mm tt"
'       Short time string:  "3:02 AM

Commenti

Il valore dell'oggetto corrente DateTime viene formattato utilizzando il criterio definito LongDatePattern dalla proprietà associata alle impostazioni cultura del thread corrente.The value of the current DateTime object is formatted using the pattern defined by the LongDatePattern property associated with the current thread culture. Il valore restituito è identico al valore restituito specificando la stringa di formato DateTime standard "D" con ToString(String) il metodo.The return value is identical to the value returned by specifying the "D" standard DateTime format string with the ToString(String) method.

Nota

La stringa restituita dal ToLongDateString metodo è dipendente dalle impostazioni cultura.The string returned by the ToLongDateString method is culture-sensitive. Riflette il modello definito dalla DateTimeFormatInfo.LongDatePattern proprietà delle impostazioni cultura correnti.It reflects the pattern defined by the current culture's DateTimeFormatInfo.LongDatePattern property. Per le impostazioni cultura en-US, ad esempio, il modello di data estesa standard è comunemente "dddd, MMMM dd, aaaa"; per le impostazioni cultura de-DE, è "dddd, d.For example, for the en-US culture, the standard long date pattern is commonly "dddd, MMMM dd, yyyy"; for the de-DE culture, it is "dddd, d. MMMM aaaa "; per le impostazioni cultura ja-JP, è "yyyy ' domenica ' d'martedì'".MMMM yyyy"; for the ja-JP culture, it is "yyyy'年'M'月'd'日'". Si noti che il valore può variare a seconda dell'implementazione di .NET e della relativa versione, del sistema operativo e della relativa versione, nonché della personalizzazione dell'utente.Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization.

Per altre informazioni sulle impostazioni cultura del thread corrente, vedere le proprietà CultureInfo.CurrentCulture e Thread.CurrentCulture.For more information about the current thread culture, see the CultureInfo.CurrentCulture and Thread.CurrentCulture properties. Per altre informazioni sui caratteri e i modelli di formato e sull'output che producono, vedere Stringhe di formato di data e ora standard e Stringhe di formato di data e ora personalizzato.For more information about format characters, format patterns, and the output they produce, see Standard date and time format strings and Custom date and time format strings. Per altre informazioni sulla modifica del modello di formato associato a un carattere di formato, vedere la classe DateTimeFormatInfo.For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

Si applica a

Vedi anche