DateTimeFormatInfo Class

Definition

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 DateTimeFormatInfoImplements IFormatProvider

Public NotInheritable Class DateTimeFormatInfoImplements ICloneable, IFormatProvider

Public NotInheritable Class DateTimeFormatInfoImplements ICloneable, IFormatProvider, ISerializable

Inheritance

Object

DateTimeFormatInfo

Attributes

SerializableAttributeComVisibleAttribute

Implements

IFormatProviderICloneableISerializable

Examples

The following example uses reflection to get the properties of theDateTimeFormatInfo object for the English (United States) culture. It displays the value of those properties that contain custom format strings and uses those strings to display formatted dates.

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.GlobalizationImports System.ReflectionModule 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 SubEnd 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

Remarks

For more information about this API, seeSupplemental API remarks for DateTimeFormatInfo.

See also

• DateTime
• Calendar
• CultureInfo