DateTime.ToShortDateString Метод

Определение

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

C#
public string ToShortDateString ();

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

String

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

Примеры

В следующем примере демонстрируется ToShortDateString метод. Также показано, что результат вызова ToShortDateString метода идентичен вызову DateTime.ToString(String) метода с "d" в качестве параметра формата.

C#
using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      DateTime dateToDisplay = new DateTime(2009, 6, 1, 8, 42, 50);
      CultureInfo originalCulture = Thread.CurrentThread.CurrentCulture;
      // Change culture to en-US.
      Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
      Console.WriteLine("Displaying short date for {0} culture:",
                        Thread.CurrentThread.CurrentCulture.Name);
      Console.WriteLine("   {0} (Short Date String)",
                        dateToDisplay.ToShortDateString());
      // Display using 'd' standard format specifier to illustrate it is
      // identical to the string returned by ToShortDateString.
      Console.WriteLine("   {0} ('d' standard format specifier)",
                        dateToDisplay.ToString("d"));
      Console.WriteLine();

      // Change culture to fr-FR.
      Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");
      Console.WriteLine("Displaying short date for {0} culture:",
                        Thread.CurrentThread.CurrentCulture.Name);
      Console.WriteLine("   {0}", dateToDisplay.ToShortDateString());
      Console.WriteLine();

      // Change culture to nl-NL.
      Thread.CurrentThread.CurrentCulture = new CultureInfo("nl-NL");
      Console.WriteLine("Displaying short date for {0} culture:",
                        Thread.CurrentThread.CurrentCulture.Name);
      Console.WriteLine("   {0}", dateToDisplay.ToShortDateString());

      // Restore original culture.
      Thread.CurrentThread.CurrentCulture = originalCulture;
   }
}
// The example displays the following output:
//       Displaying short date for en-US culture:
//          6/1/2009 (Short Date String)
//          6/1/2009 ('d' standard format specifier)
//
//       Displaying short date for fr-FR culture:
//          01/06/2009
//
//       Displaying short date for nl-NL culture:
//          1-6-2009

Комментарии

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

Примечание

Строка, возвращаемая методом ToShortDateString , учитывает язык и региональные параметры. Он отражает шаблон, определенный свойством текущего языка и региональных параметров DateTimeFormatInfo.ShortDatePattern . Например, для языка и региональных параметров en-US стандартный шаблон короткой даты — "M/d/yyyyy"; для языка de-DE это "dd.MM.yyyyy"; для языка и региональных параметров ja-JP это "гггг/ММ/дд". Обратите внимание, что его значение может отличаться в зависимости от реализации .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
.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
.NET Standard 2.0, 2.1

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