DateTimeFormatInfo.ShortDatePattern Свойство

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

Исходный код:

DateTimeFormatInfo.cs

Получает или задает строку пользовательского формата для короткого значения даты.

public:
 property System::String ^ ShortDatePattern { System::String ^ get(); void set(System::String ^ value); };

public string ShortDatePattern { get; set; }

member this.ShortDatePattern : string with get, set

Public Property ShortDatePattern As String

Значение свойства

String

Строка пользовательского формата для короткого значения даты.

Исключения

ArgumentNullException

Для свойства задается значение null.

InvalidOperationException

Для свойства задается значение, а объект DateTimeFormatInfo доступен только для чтения.

Примеры

В следующем примере отображается значение ShortDatePattern свойства и значение даты, отформатированного с помощью ShortDatePattern свойства для нескольких языков и региональных параметров.

using System;
using System.Globalization;

public class SamplesDTFI
{
   public static void Main()
   {
      string[]  cultures = { "en-US", "ja-JP", "fr-FR" };
      DateTime date1 = new DateTime(2011, 5, 1);

      Console.WriteLine(" {0,7} {1,19} {2,10}\n", "CULTURE", "PROPERTY VALUE", "DATE");

      foreach (var culture in cultures) {
         DateTimeFormatInfo dtfi = CultureInfo.CreateSpecificCulture(culture).DateTimeFormat;
         Console.WriteLine(" {0,7} {1,19} {2,10}", culture,
                           dtfi.ShortDatePattern,
                           date1.ToString("d", dtfi));
      }
   }
}
// The example displays the following output:
//        CULTURE      PROPERTY VALUE       DATE
//
//          en-US            M/d/yyyy   5/1/2011
//          ja-JP          yyyy/MM/dd 2011/05/01
//          fr-FR          dd/MM/yyyy 01/05/2011

Imports System.Globalization

Public Class SamplesDTFI
   Public Shared Sub Main()
      Dim cultures() As String = { "en-US", "ja-JP", "fr-FR" }
      Dim date1 As Date = #05/01/2011#
      
      Console.WriteLine(" {0,7} {1,19} {2,10}", "CULTURE", "PROPERTY VALUE", "DATE")
      Console.WriteLine()
      
      For Each culture As String In cultures
         Dim dtfi As DateTimeFormatInfo = CultureInfo.CreateSpecificCulture(culture).DateTimeFormat
         Console.WriteLine(" {0,7} {1,19} {2,10}", culture, 
                           dtfi.ShortDatePattern, 
                           date1.ToString("d", dtfi))
      Next                     
   End Sub 
End Class
' The example displays the following output:
'        CULTURE      PROPERTY VALUE       DATE
'       
'          en-US            M/d/yyyy   5/1/2011
'          ja-JP          yyyy/MM/dd 2011/05/01
'          fr-FR          dd/MM/yyyy 01/05/2011

В следующем примере изменяется ShortDatePattern свойство DateTimeFormatInfo объекта , представляющего соглашения о форматировании для английского языка и региональных параметров (США). Он также дважды отображает значение даты, сначала для отражения исходного ShortDatePattern свойства, а затем для отражения нового значения свойства.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTimeFormatInfo dtfi = CultureInfo.CreateSpecificCulture("en-US").DateTimeFormat;
      DateTime date1 = new DateTime(2011, 5, 1);
      Console.WriteLine("Original Short Date Pattern:");
      Console.WriteLine("   {0}: {1}", dtfi.ShortDatePattern,
                                       date1.ToString("d", dtfi));
      dtfi.DateSeparator = "-";
      dtfi.ShortDatePattern = @"yyyy/MM/dd";
      Console.WriteLine("Revised Short Date Pattern:");
      Console.WriteLine("   {0}: {1}", dtfi.ShortDatePattern,
                                       date1.ToString("d", dtfi));
   }
}
// The example displays the following output:
//       Original Short Date Pattern:
//          M/d/yyyy: 5/1/2011
//       Revised Short Date Pattern:
//          yyyy/MM/dd: 2011-05-01

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim dtfi As DateTimeFormatInfo = CultureInfo.CreateSpecificCulture("en-US").DateTimeFormat
      Dim date1 As DateTime = #05/01/2011#
      Console.WriteLine("Original Short Date Pattern:")
      Console.WriteLine("   {0}: {1}", dtfi.ShortDatePattern, 
                                       date1.ToString("d", dtfi))
      dtfi.DateSeparator = "-"
      dtfi.ShortDatePattern = "yyyy/MM/dd"
      Console.WriteLine("Revised Short Date Pattern:")
      Console.WriteLine("   {0}: {1}", dtfi.ShortDatePattern, 
                                       date1.ToString("d", dtfi))
   End Sub
End Module
' The example displays the following output:
'    Original Short Date Pattern:
'       M/d/yyyy: 5/1/2011
'    Revised Short Date Pattern:
'       YYYY/MM/dd: 2011-05-01

Комментарии

Свойство ShortDatePattern определяет зависящий от языка и региональных параметров формат строк даты, возвращаемых вызовами DateTime.ToString методов и , DateTimeOffset.ToString а также строками составного формата, которые предоставляются строкой стандартного формата "d".

Это свойство затрагивается при изменении значения Calendar свойства.

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

• Строки стандартных форматов даты и времени
• Строки настраиваемых форматов даты и времени