DateTime.ToLongDateString Метод

Определение

Преобразует значение текущего объекта DateTime в эквивалентное ему длинное строковое представление даты.

public string ToLongDateString ();

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

Строка, содержащая длинное строковое представление даты текущего объекта DateTime.

Примеры

В следующем примере демонстрируется ToLongDateString метод.

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"

Комментарии

Значение текущего DateTime объекта форматируется с помощью шаблона, определенного свойством , LongDatePattern связанным с текущим языком и региональными параметрами. Возвращаемое значение идентично значению, возвращаемого путем указания стандартной строки формата DateTime "D" с ToString(String) помощью метода .

Примечание

Строка, возвращаемая методом ToLongDateString , учитывает язык и региональные параметры. Он отражает шаблон, определенный свойством текущего языка DateTimeFormatInfo.LongDatePattern и региональных параметров. Например, для языка и региональных параметров en-US стандартным шаблоном длинных дат обычно является "дддд, ММММ дд, гггг"; для языка de-DE это "dddd, d. ММММ гггг"; для культуры ja-JP это "yyyy'年'M'月'd'日'". Обратите внимание, что его значение может отличаться в зависимости от реализации и версии .NET, операционной системы и ее версии, а также от настроек пользователя.

Дополнительные сведения о текущих языке и региональных параметрах потока см. в статьях о свойствах CultureInfo.CurrentCulture и Thread.CurrentCulture. Дополнительные сведения о символах и шаблонах формата, а также создаваемых ими выходных данных см. в статьях Строки стандартных форматов даты и времени и Строки настраиваемых форматов даты и времени. Дополнительные сведения об изменении шаблона формата, связанного с символом формата, см. в статье о классе DateTimeFormatInfo.

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

Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

См. также раздел