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 の詳細については、「DateTimeFormatInfoの補足 API 解説 参照してください。

コンストラクター

DateTimeFormatInfo()

カルチャに依存しない (不変) DateTimeFormatInfo クラスの新しい書き込み可能なインスタンスを初期化します。

プロパティ

AbbreviatedDayNames

曜日のカルチャ固有の省略名を含む String 型の 1 次元配列を取得または設定します。

AbbreviatedMonthGenitiveNames

現在の DateTimeFormatInfo オブジェクトに関連付けられている省略された月の名前の文字列配列を取得または設定します。

AbbreviatedMonthNames

月のカルチャ固有の省略名を含む 1 次元文字列配列を取得または設定します。

AMDesignator

"ante meridiem" (正午前) の時間の文字列指定子を取得または設定します。

Calendar

現在のカルチャに使用するカレンダーを取得または設定します。

CalendarWeekRule

年の最初のカレンダー週を決定するために使用するルールを指定する値を取得または設定します。

CurrentInfo

現在のカルチャに基づいて値を書式設定する読み取り専用の DateTimeFormatInfo オブジェクトを取得します。

DateSeparator

日付の構成要素 (年、月、日) を区切る文字列を取得または設定します。

DayNames

曜日のカルチャ固有の完全名を含む 1 次元文字列配列を取得または設定します。

FirstDayOfWeek

週の最初の曜日を取得または設定します。

FullDateTimePattern

長い日付と長い時間の値のカスタム書式指定文字列を取得または設定します。

InvariantInfo

カルチャに依存しない (不変) 既定の読み取り専用 DateTimeFormatInfo オブジェクトを取得します。

IsReadOnly

DateTimeFormatInfo オブジェクトが読み取り専用かどうかを示す値を取得します。

LongDatePattern

長い日付値のカスタム書式指定文字列を取得または設定します。

LongTimePattern

長い時間値のカスタム書式指定文字列を取得または設定します。

MonthDayPattern

月と日の値のカスタム書式指定文字列を取得または設定します。

MonthGenitiveNames

現在の DateTimeFormatInfo オブジェクトに関連付けられている月の名前の文字列配列を取得または設定します。

MonthNames

月のカルチャ固有の完全名を含む String 型の 1 次元配列を取得または設定します。

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)

明示的なインターフェイスの実装

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

ターゲット オブジェクトをシリアル化するために必要なデータを SerializationInfo に設定します。

適用対象

こちらもご覧ください