DateTimeFormatInfo Класс

Определение

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

System.Globalization

Сборка:

System.Runtime.dll

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

DateTimeFormatInfo.cs

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

public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider

public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider

type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider

Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider

Наследование

Object

DateTimeFormatInfo

Реализации

IFormatProvider ICloneable

Примеры

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

using System;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Get the properties of an en-US DateTimeFormatInfo object.
      DateTimeFormatInfo dtfi = CultureInfo.GetCultureInfo("en-US").DateTimeFormat;
      Type typ = dtfi.GetType();
      PropertyInfo[] props = typ.GetProperties();
      DateTime value = new DateTime(2012, 5, 28, 11, 35, 0);

      foreach (var prop in props) {
         // Is this a format pattern-related property?
         if (prop.Name.Contains("Pattern")) {
            string fmt = prop.GetValue(dtfi, null).ToString();
            Console.WriteLine("{0,-33} {1} \n{2,-37}Example: {3}\n",
                              prop.Name + ":", fmt, "",
                              value.ToString(fmt));
         }
      }
   }
}
// The example displays the following output:
//    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
//                                         Example: Monday, May 28, 2012 11:35:00 AM
//
//    LongDatePattern:                  dddd, MMMM dd, yyyy
//                                         Example: Monday, May 28, 2012
//
//    LongTimePattern:                  h:mm:ss tt
//                                         Example: 11:35:00 AM
//
//    MonthDayPattern:                  MMMM dd
//                                         Example: May 28
//
//    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
//                                         Example: Mon, 28 May 2012 11:35:00 GMT
//
//    ShortDatePattern:                 M/d/yyyy
//                                         Example: 5/28/2012
//
//    ShortTimePattern:                 h:mm tt
//                                         Example: 11:35 AM
//
//    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
//                                         Example: 2012-05-28T11:35:00
//
//    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
//                                         Example: 2012-05-28 11:35:00Z
//
//    YearMonthPattern:                 MMMM, yyyy
//                                         Example: May, 2012

Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Get the properties of an en-US DateTimeFormatInfo object.
      Dim dtfi As DateTimeFormatInfo = CultureInfo.GetCultureInfo("en-US").DateTimeFormat
      Dim typ As Type = dtfi.GetType()
      Dim props() As PropertyInfo = typ.GetProperties()
      Dim value As Date = #05/28/2012 11:35AM# 
      
      For Each prop In props
         ' Is this a format pattern-related property?
         If prop.Name.Contains("Pattern") Then
            Dim fmt As String = CStr(prop.GetValue(dtfi, Nothing))
            Console.WriteLine("{0,-33} {1} {2}{3,-37}Example: {4}", 
                              prop.Name + ":", fmt, vbCrLf, "",
                              value.ToString(fmt)) 
            Console.WriteLine()
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
'                                         Example: Monday, May 28, 2012 11:35:00 AM
'    
'    LongDatePattern:                  dddd, MMMM dd, yyyy
'                                         Example: Monday, May 28, 2012
'    
'    LongTimePattern:                  h:mm:ss tt
'                                         Example: 11:35:00 AM
'    
'    MonthDayPattern:                  MMMM dd
'                                         Example: May 28
'    
'    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
'                                         Example: Mon, 28 May 2012 11:35:00 GMT
'    
'    ShortDatePattern:                 M/d/yyyy
'                                         Example: 5/28/2012
'    
'    ShortTimePattern:                 h:mm tt
'                                         Example: 11:35 AM
'    
'    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
'                                         Example: 2012-05-28T11:35:00
'    
'    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
'                                         Example: 2012-05-28 11:35:00Z
'    
'    YearMonthPattern:                 MMMM, yyyy
'                                         Example: May, 2012

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для DateTimeFormatInfo.

Конструкторы

DateTimeFormatInfo()

Инициализирует новый записываемый экземпляр класса DateTimeFormatInfo, который является независимым от языка и региональных параметров (инвариантный).

Свойства

AbbreviatedDayNames	Возвращает или задает одномерный массив типа String, содержащий сокращенные имена дней недели, зависящие от языка и региональных параметров.
AbbreviatedMonthGenitiveNames	Возвращает или задает строковый массив сокращенных имен месяцев, связанных с текущим объектом DateTimeFormatInfo.
AbbreviatedMonthNames	Возвращает или задает одномерный массив строк, содержащий сокращенные имена месяцев, зависящих от языка и региональных параметров.
AMDesignator	Возвращает или задает строковый конструктор в течение нескольких часов, которые являются "ante meridiem" (до полудня).
Calendar	Возвращает или задает календарь, используемый для текущего языка и региональных параметров.
CalendarWeekRule	Возвращает или задает значение, указывающее, какое правило используется для определения первой календарной недели года.
CurrentInfo	Возвращает объект только для чтения DateTimeFormatInfo, который форматирует значения на основе текущего языка и региональных параметров.
DateSeparator	Возвращает или задает строку, разделяющую компоненты даты, то есть год, месяц и день.
DayNames	Возвращает или задает одномерный массив строк, содержащий полные имена дней недели, зависящие от языка и региональных параметров.
FirstDayOfWeek	Возвращает или задает первый день недели.
FullDateTimePattern	Возвращает или задает строку настраиваемого формата для длительной даты и длительного времени.
InvariantInfo	Возвращает объект, доступный только для чтения, DateTimeFormatInfo, не зависящий от языка и региональных параметров (инвариантный).
IsReadOnly	Возвращает значение, указывающее, доступен ли объект DateTimeFormatInfo только для чтения.
LongDatePattern	Возвращает или задает строку настраиваемого формата для значения длинной даты.
LongTimePattern	Возвращает или задает строку настраиваемого формата для длительного времени.
MonthDayPattern	Возвращает или задает строку настраиваемого формата в течение месяца и дня.
MonthGenitiveNames	Возвращает или задает строковый массив имен месяцев, связанных с текущим объектом DateTimeFormatInfo.
MonthNames	Возвращает или задает одномерный массив типа String, содержащий полные имена языков и региональных параметров месяцев.
NativeCalendarName	Возвращает собственное имя календаря, связанного с текущим объектом DateTimeFormatInfo.
PMDesignator	Возвращает или задает строковый конструктор в течение нескольких часов, которые являются "post meridiem" (после полудня).
RFC1123Pattern	Возвращает строку настраиваемого формата для значения времени, основанного на спецификации IETF (Запрос на комментарии (RFC) 1123.
ShortDatePattern	Возвращает или задает строку пользовательского формата для короткого значения даты.
ShortestDayNames	Возвращает или задает строковый массив самых коротких уникальных сокращенных имен дней, связанных с текущим объектом DateTimeFormatInfo.
ShortTimePattern	Возвращает или задает строку настраиваемого формата для короткого значения времени.
SortableDateTimePattern	Возвращает строку настраиваемого формата для отсортируемых значений даты и времени.
TimeSeparator	Возвращает или задает строку, разделяющую компоненты времени, то есть час, минуты и секунды.
UniversalSortableDateTimePattern	Возвращает строку пользовательского формата для универсальной, сортируемой строки даты и времени, как определено ISO 8601.
YearMonthPattern	Возвращает или задает строку настраиваемого формата в течение года и месяца.

Методы

Clone()	Создает неглубокую копию DateTimeFormatInfo.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetAbbreviatedDayName(DayOfWeek)	Возвращает сокращенное имя определенного языка и региональных параметров указанного дня недели на основе языка и региональных параметров, связанных с текущим объектом DateTimeFormatInfo.
GetAbbreviatedEraName(Int32)	Возвращает строку, содержащую сокращенное имя указанной эпохи, если аббревиатура существует.
GetAbbreviatedMonthName(Int32)	Возвращает сокращенное имя определенного языка и региональных параметров указанного месяца на основе языка и региональных параметров, связанных с текущим объектом DateTimeFormatInfo.
GetAllDateTimePatterns()	Возвращает все стандартные шаблоны, в которых можно отформатировать значения даты и времени.
GetAllDateTimePatterns(Char)	Возвращает все шаблоны, в которых значения даты и времени можно отформатировать с помощью указанной строки стандартного формата.
GetDayName(DayOfWeek)	Возвращает полное имя определенного языка и региональных параметров указанного дня недели на основе языка и региональных параметров, связанных с текущим объектом DateTimeFormatInfo.
GetEra(String)	Возвращает целое число, представляющее указанную эру.
GetEraName(Int32)	Возвращает строку, содержащую имя указанной эпохи.
GetFormat(Type)	Возвращает объект указанного типа, предоставляющий службу форматирования даты и времени.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInstance(IFormatProvider)	Возвращает объект DateTimeFormatInfo, связанный с указанным IFormatProvider.
GetMonthName(Int32)	Возвращает полное имя конкретного языка и региональных параметров указанного месяца на основе языка и региональных параметров, связанных с текущим объектом DateTimeFormatInfo.
GetShortestDayName(DayOfWeek)	Получает короткое сокращенное имя дня для указанного дня недели, связанного с текущим объектом DateTimeFormatInfo.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ReadOnly(DateTimeFormatInfo)	Возвращает оболочку только для чтения DateTimeFormatInfo.
SetAllDateTimePatterns(String[], Char)	Задает строки настраиваемого формата даты и времени, соответствующие заданной строке стандартного формата.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• DateTime
• Calendar
• CultureInfo