DateTime.ToLongDateString Méthode

Définition

Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne de date longue équivalente.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

Retours

Chaîne qui contient la représentation sous forme de chaîne de date longue de l'objet DateTime actuel.A string that contains the long date string representation of the current DateTime object.

Exemples

L’exemple suivant illustre la méthode ToLongDateString.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
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

Remarques

La valeur de l’objet DateTime actuel est mise en forme à l’aide du modèle défini par la propriété LongDatePattern associée à la culture du thread actuel.The value of the current DateTime object is formatted using the pattern defined by the LongDatePattern property associated with the current thread culture. La valeur de retour est identique à la valeur retournée en spécifiant la chaîne de format DateTime standard « D » avec la méthode ToString(String).The return value is identical to the value returned by specifying the "D" standard DateTime format string with the ToString(String) method.

Notes

La chaîne retournée par la méthode ToLongDateString est dépendante de la culture.The string returned by the ToLongDateString method is culture-sensitive. Elle reflète le modèle défini par la propriété DateTimeFormatInfo.LongDatePattern de la culture actuelle.It reflects the pattern defined by the current culture's DateTimeFormatInfo.LongDatePattern property. Par exemple, pour la culture en-US, le modèle de date longue standard est généralement « dddd, MMMM DD, yyyy »; pour la culture de-DE, il s’agit 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 yyyy "; pour la culture ja-JP, il s’agit de « yyyy » 年 « 月’日 ».MMMM yyyy"; for the ja-JP culture, it is "yyyy'年'M'月'd'日'". Notez que sa valeur peut varier en fonction de l’implémentation .NET et de sa version, du système d’exploitation et de sa version, ainsi que de la personnalisation de l’utilisateur.Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization.

Pour en savoir plus sur la culture actuelle du thread, consultez les propriétés CultureInfo.CurrentCulture et Thread.CurrentCulture.For more information about the current thread culture, see the CultureInfo.CurrentCulture and Thread.CurrentCulture properties. Pour en savoir plus sur les caractères de format, les modèles de format et la sortie qu’ils produisent, voir Chaînes de format de date et d’heure standard et Chaînes de format de date et d’heure personnalisées.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. Pour en savoir plus sur la modification du modèle de format associé à un caractère de format, consultez la classe DateTimeFormatInfo.For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

S’applique à

Voir aussi