DateTime.ToShortDateString Método

Definição

Converte o valor do atual objeto DateTime na representação de cadeia de caracteres de data abreviada equivalente.Converts the value of the current DateTime object to its equivalent short date string representation.

public:
 System::String ^ ToShortDateString();
public string ToShortDateString ();
member this.ToShortDateString : unit -> string
Public Function ToShortDateString () As String

Retornos

Uma cadeia de caracteres que contém a representação de cadeia de caracteres de data abreviada do atual objeto DateTime.A string that contains the short date string representation of the current DateTime object.

Exemplos

O exemplo a seguir demonstra o método ToShortDateString.The following example demonstrates the ToShortDateString method. Ele também mostra que o resultado da chamada do método ToShortDateString é idêntico à chamada do método DateTime.ToString(String) com "d" como o parâmetro format.It also shows that the result of calling the ToShortDateString method is identical to calling the DateTime.ToString(String) method with "d" as the format parameter.

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
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 de DateTime atual é formatado usando o padrão definido pela propriedade DateTimeFormatInfo.ShortDatePattern associada à cultura de thread atual.The value of the current DateTime object is formatted using the pattern defined by the DateTimeFormatInfo.ShortDatePattern property associated with the current thread culture. O valor de retorno é idêntico ao valor retornado pela especificação da cadeia de caracteres de formato DateTime padrão "d" com o método ToString(String).The return value is identical to the value returned by specifying the "d" standard DateTime format string with the ToString(String) method.

Observação

A cadeia de caracteres retornada pelo método de ToShortDateString é sensível à cultura.The string returned by the ToShortDateString method is culture-sensitive. Ele reflete o padrão definido pela propriedade de DateTimeFormatInfo.ShortDatePattern da cultura atual.It reflects the pattern defined by the current culture's DateTimeFormatInfo.ShortDatePattern property. Por exemplo, para a cultura en-US, o padrão de data abreviada Standard é "M/d/yyyy"; para a cultura de-DE, é "dd. MM. aaaa "; para a cultura ja-JP, é "aaaa/MM/DD".For example, for the en-US culture, the standard short date pattern is "M/d/yyyy"; for the de-DE culture, it is "dd.MM.yyyy"; for the ja-JP culture, it is "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.Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization.

Para obter mais informações sobre a cultura do thread atual, confira as propriedades CultureInfo.CurrentCulture e Thread.CurrentCulture.For more information about the current thread culture, see the CultureInfo.CurrentCulture and Thread.CurrentCulture properties. 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.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. Para obter mais informações sobre como alterar o padrão de formato associado a um caractere de formato, consulte a classe DateTimeFormatInfo.For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

Aplica-se a

Veja também