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 型の 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)

こちらもご覧ください

• DateTime
• Calendar
• CultureInfo