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 object. |
PMDesignator |
Возвращает или задает строку указателя часов после полудня (PМ — "post meridiem"). |
RFC1123Pattern |
Получает строку пользовательского формата для значения времени, основанного на спецификации IETF Request for Comments 1123 (RFC IETF). |
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 данными, необходимыми для сериализации целевого объекта. |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по