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 的詳細資訊，請參閱 DateTimeFormatInfo的補充 API 備註。

建構函式

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)	傳回與指定之 IFormatProvider相關聯的 DateTimeFormatInfo 物件。
GetMonthName(Int32)	根據與目前 DateTimeFormatInfo 對象相關聯的文化特性，傳回指定月份的文化特性特定完整名稱。
GetShortestDayName(DayOfWeek)	取得與目前 DateTimeFormatInfo 對象相關聯之指定星期的最短縮寫日名稱。
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ReadOnly(DateTimeFormatInfo)	傳回只讀 DateTimeFormatInfo 包裝函式。
SetAllDateTimePatterns(String[], Char)	設定對應至指定標準格式字串的自訂日期和時間格式字串。
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

另請參閱

• DateTime
• Calendar
• CultureInfo