DateTimeFormatInfo Класс

Определение

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

public ref class DateTimeFormatInfo sealed : IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider, System::Runtime::Serialization::ISerializable
public sealed class DateTimeFormatInfo : IFormatProvider
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
[System.Serializable]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider, System.Runtime.Serialization.ISerializable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
type DateTimeFormatInfo = class
    interface IFormatProvider
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
    interface ISerializable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider, ISerializable
Наследование
DateTimeFormatInfo
Атрибуты
Реализации

Примеры

В следующем примере используется отражение для получения свойств объекта 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)

Явные реализации интерфейса

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет SerializationInfo данными, необходимыми для сериализации целевого объекта.

Применяется к

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