DateTime.ToLongDateString Метод

Определение

Преобразует значение текущего объекта DateTime в эквивалентное ему длинное строковое представление даты.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

Возвращаемое значение

Строка, содержащая длинное строковое представление даты текущего объекта DateTime.A string that contains the long date string representation of the current DateTime object.

Примеры

В следующем примере демонстрируется метод 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

Комментарии

Значение текущего объекта DateTime форматируется с использованием шаблона, определенного свойством LongDatePattern, связанным с языком и региональными параметрами текущего потока.The value of the current DateTime object is formatted using the pattern defined by the LongDatePattern property associated with the current thread culture. Возвращаемое значение идентично значению, возвращаемому путем указания строки стандартного формата DateTime "D" с помощью метода ToString(String).The return value is identical to the value returned by specifying the "D" standard DateTime format string with the ToString(String) method.

Примечание

Строка, возвращаемая методом ToLongDateString, зависит от языка и региональных параметров.The string returned by the ToLongDateString method is culture-sensitive. Он отражает шаблон, определенный свойством DateTimeFormatInfo.LongDatePattern текущего языка и региональных параметров.It reflects the pattern defined by the current culture's DateTimeFormatInfo.LongDatePattern property. Например, для языка и региональных параметров en-US стандартный длинный шаблон даты обычно имеет формат dddd, мммм дд, гггг. для региональных параметров 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. ММММ гггг "; для языка и региональных параметров ja-JP это "yyyy" 年 "月 d" 日 "".MMMM yyyy"; for the ja-JP culture, it is "yyyy'年'M'月'd'日'". Обратите внимание, что его значение может изменяться в зависимости от реализации .NET и ее версии, операционной системы и ее версии, а также пользовательской настройки.Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization.

Дополнительные сведения о текущих языке и региональных параметрах потока см. в статьях о свойствах CultureInfo.CurrentCulture и Thread.CurrentCulture.For more information about the current thread culture, see the CultureInfo.CurrentCulture and Thread.CurrentCulture properties. Дополнительные сведения о символах и шаблонах формата, а также создаваемых ими выходных данных см. в статьях Строки стандартных форматов даты и времени и Строки настраиваемых форматов даты и времени.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. Дополнительные сведения об изменении шаблона формата, связанного с символом формата, см. в статье о классе DateTimeFormatInfo.For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

Применяется к

Дополнительно