DateTime.ToShortDateString Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Origem:

DateTime.cs

Converte o valor do atual objeto DateTime na representação de cadeia de caracteres de data abreviada equivalente.

C#

public string ToShortDateString();

Retornos

String

Uma cadeia de caracteres que contém a representação de cadeia de caracteres de data abreviada do atual objeto DateTime.

Exemplos

O exemplo a seguir demonstra o ToShortDateString método. Ele também mostra que o resultado da chamada do ToShortDateString método é idêntico a chamar o DateTime.ToString(String) método com "d" como o parâmetro de formato.

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

Comentários

O valor do objeto atual DateTime é formatado usando o padrão definido pela DateTimeFormatInfo.ShortDatePattern propriedade associada à cultura atual. O valor retornado é idêntico ao valor retornado especificando a cadeia de caracteres de formato DateTime padrão "d" com o ToString(String) método .

Observação

A cadeia de caracteres retornada pelo ToShortDateString método diferencia a cultura. Ele reflete o padrão definido pela propriedade da DateTimeFormatInfo.ShortDatePattern cultura atual. Por exemplo, para a cultura en-US, o padrão padrão de data curta é "M/d/yyyy"; para a cultura de de-DE, é "dd.MM.yyyy"; para a cultura ja-JP, é "yyyy/MM/dd". Observe que seu valor pode variar dependendo da implementação do .NET e de sua versão, do sistema operacional e de sua versão e da personalização do usuário.

Para obter mais informações sobre a cultura do thread atual, confira as propriedades CultureInfo.CurrentCulture e Thread.CurrentCulture. Para obter mais informações sobre caracteres, padrões de formatos e a saída que eles produzem, confira Cadeias de caracteres de formato padrão de data e hora e Cadeias de caracteres de formato personalizado de data e hora. Para obter mais informações sobre como alterar o padrão de formato associado a um caractere de formato, consulte a classe DateTimeFormatInfo.

Aplica-se a

Confira também

• CultureInfo
• DateTimeFormat
• DateTimeFormatInfo
• ToString()
• Tipos de formatação no .NET
• Cadeias de caracteres de formato de data e hora personalizado