DateTimeConverter

.NET Framework クラス ライブラリ リファレンス

DateTimeConverter クラス

DateTime 型オブジェクトのさまざまな表現への変換や、その逆の変換を行う型コンバータを提供します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class DateTimeConverter
    Inherits TypeConverter

Visual Basic (使用法)

Dim instance As DateTimeConverter

C#

public class DateTimeConverter : TypeConverter

C++

public ref class DateTimeConverter : public
 TypeConverter

J#

public class DateTimeConverter extends TypeConverter

JScript

public class DateTimeConverter extends
 TypeConverter

解説

このコンバータは、DateTime 型オブジェクトの文字列への変換と、その逆の変換だけを実行できます。

ConvertFrom メソッドでは、DateTime クラスの Parse メソッドを使用して、文字列からの変換を行います。

CultureInfo が提供されていない場合、ConvertTo メソッドでは、現在のカルチャが使用されます。通常、ConvertTo は、ShortDatePattern プロパティを使用して日付を書式化し、ShortDatePattern プロパティと ShortTimePattern プロパティを使用して日付と時刻を書式化します。InvariantCulture プロパティが渡された場合、ConvertTo は、日付を yyyy-mm-dd 書式に設定し、ToString を使用して日付と時刻を書式化します。

型コンバータの詳細については、TypeConverter 基本クラスのトピックおよび「方法 : 型コンバータを実装する」を参照してください。

メモ
DateTimeConverter のインスタンスは作成しないでください。代わりに、TypeDescriptor クラスの GetConverter メソッドを呼び出します。詳細については、TypeConverter 基本クラスのトピックの例を参照してください。 このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

DateTime 型の変数を文字列に変換する方法と、その逆の変換を行う方法を次のコード例に示します。

Visual Basic

Dim dt As New DateTime(1990,
 5, 6)
Console.WriteLine(TypeDescriptor.GetConverter(dt).ConvertTo(dt, GetType(String)))
Dim myStr As String = "1991-10-10"
Console.WriteLine(TypeDescriptor.GetConverter(dt).ConvertFrom(myStr))

C#

DateTime dt=new DateTime(1990,5,6);
Console.WriteLine(TypeDescriptor.GetConverter(dt).ConvertTo(dt, typeof(string)));
string myStr="1991-10-10";
Console.WriteLine(TypeDescriptor.GetConverter(dt).ConvertFrom(myStr));

C++

DateTime dt(1990,5,6);
Console::WriteLine( TypeDescriptor::GetConverter( dt )->ConvertTo( dt, String::typeid
 ) );
String^ myStr = "1991-10-10";
Console::WriteLine( TypeDescriptor::GetConverter( dt )->ConvertFrom( myStr ) );

J#

DateTime dt = new DateTime(1990, 5, 6);
Console.WriteLine(TypeDescriptor.GetConverter(dt).ConvertTo(dt,
    String.class.ToType()));
String myStr = "1991-10-10";
Console.WriteLine(TypeDescriptor.GetConverter(dt).ConvertFrom(myStr));

継承階層

System.Object
   System.ComponentModel.TypeConverter
    System.ComponentModel.DateTimeConverter

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DateTimeConverter メンバ
System.ComponentModel 名前空間

DateTimeConverter コンストラクタ

DateTimeConverter クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DateTimeConverter

C#

public DateTimeConverter ()

C++

public:
DateTimeConverter ()

J#

public DateTimeConverter ()

JScript

public function DateTimeConverter ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DateTimeConverter クラス
DateTimeConverter メンバ
System.ComponentModel 名前空間

DateTimeConverter メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanConvertFrom	オーバーロードされます。 コンバータが特定の型のオブジェクトをコンバータの型に変換できるかどうかを示す値を返します。
	CanConvertTo	オーバーロードされます。 コンバータがオブジェクトを指定した型に変換できるかどうかを示す値を返します。
	ConvertFrom	オーバーロードされます。 指定した値をコンバータの型に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 ( TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 ( TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 指定した値オブジェクトを、指定した型に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 ( TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 ( TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 ( TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 ( TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 ( TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 型コンバータがデザインされた対象のデータ型の標準値のコレクションを返します。 ( TypeConverter から継承されます。)
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 ( TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 ( TypeConverter から継承されます。)

参照

関連項目

DateTimeConverter クラス
System.ComponentModel 名前空間

DateTimeConverter メンバ

DateTime 型オブジェクトのさまざまな表現への変換や、その逆の変換を行う型コンバータを提供します。

DateTimeConverter データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DateTimeConverter	DateTimeConverter クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanConvertFrom	オーバーロードされます。 コンバータが特定の型のオブジェクトをコンバータの型に変換できるかどうかを示す値を返します。
	CanConvertTo	オーバーロードされます。 コンバータがオブジェクトを指定した型に変換できるかどうかを示す値を返します。
	ConvertFrom	オーバーロードされます。 指定した値をコンバータの型に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 (TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 (TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 指定した値オブジェクトを、指定した型に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 (TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 (TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 (TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 (TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 (TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 型コンバータがデザインされた対象のデータ型の標準値のコレクションを返します。 (TypeConverter から継承されます。)
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる標準値セットをオブジェクトがサポートするかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 (TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 (TypeConverter から継承されます。)

参照

関連項目

DateTimeConverter クラス
System.ComponentModel 名前空間