DateTime.ToShortDateString Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTime.cs

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

public:
 System::String ^ ToShortDateString();

public string ToShortDateString ();

member this.ToShortDateString : unit -> string

Public Function ToShortDateString () As String

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.

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

open System
open System.Globalization
open System.Threading

let dateToDisplay = DateTime(2009, 6, 1, 8, 42, 50)
let originalCulture = Thread.CurrentThread.CurrentCulture
// Change culture to en-US.
Thread.CurrentThread.CurrentCulture <- CultureInfo "en-US"
printfn "Displaying short date for {Thread.CurrentThread.CurrentCulture.Name} culture:"
printfn $"   {dateToDisplay.ToShortDateString()} (Short Date String)"

// Display using 'd' standard format specifier to illustrate it is
// identical to the string returned by ToShortDateString.
printfn $"   {dateToDisplay:d} ('d' standard format specifier)\n"

// Change culture to fr-FR.
Thread.CurrentThread.CurrentCulture <- CultureInfo "fr-FR"
printfn $"Displaying short date for {Thread.CurrentThread.CurrentCulture.Name} culture:"
printfn $"   {dateToDisplay.ToShortDateString()}\n"

// Change culture to nl-NL.
Thread.CurrentThread.CurrentCulture <- CultureInfo "nl-NL"
printfn $"Displaying short date for {Thread.CurrentThread.CurrentCulture.Name} culture:"
printfn $"   {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

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      Dim dateToDisplay As Date = #06/01/2009 8:42:50#
      Dim originalCulture As CultureInfo = 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
   End Sub
End Module
' 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.

Confira também

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