DateTime.Subtract

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

DateTime.Subtract メソッド (DateTime)

このインスタンスから指定した日付と時刻を減算します。

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

Visual Basic (宣言)

Public Function Subtract ( _
    value As DateTime _
) As TimeSpan

Visual Basic (使用法)

Dim instance As DateTime
Dim value As DateTime
Dim returnValue As TimeSpan

returnValue = instance.Subtract(value)

C#

public TimeSpan Subtract (
    DateTime value
)

C++

public:
TimeSpan Subtract (
    DateTime value
)

J#

public TimeSpan Subtract (
    DateTime value
)

JScript

public function Subtract (
    value : DateTime
) : TimeSpan

パラメータ

value

DateTime のインスタンス。

戻り値
このインスタンスで表された日付と時刻から value で表された日付と時刻を減算した値である TimeSpan 間隔。

例外

例外の種類	条件
ArgumentOutOfRangeException	結果が MinValue より小さい値か、MaxValue より大きい値です。

解説

このメソッドは、この DateTime オブジェクトの値を変更しません。代わりに、この操作の結果を示す値を持つ新しい TimeSpan が返されます。

DateTime オブジェクト間の減算を行う場合は、あらかじめ両方のオブジェクトが同じタイム ゾーンの時刻を表すことを確認してください。そうしないと、結果にタイム ゾーン間の時差が反映されてしまいます。

使用例

Subtract メソッドおよび演算子のコード例を次に示します。

Visual Basic

Dim date1 As New System.DateTime(1996,
 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996,
 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996,
 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

C#

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15,
 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2,
 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42,
 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

C++

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = System::DateTime( 1996, 10, 12, 8, 42, 0 );

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract( date1 );

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract( diff1 );

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

J#

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15,
 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2,
 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42,
 0);
// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);
// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);
// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2.Subtract(date3);
// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1.Subtract(diff2);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DateTime 構造体
DateTime メンバ
System 名前空間

DateTime.Subtract メソッド (TimeSpan)

このインスタンスから指定した存続時間を減算します。

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

Visual Basic (宣言)

Public Function Subtract ( _
    value As TimeSpan _
) As DateTime

Visual Basic (使用法)

Dim instance As DateTime
Dim value As TimeSpan
Dim returnValue As DateTime

returnValue = instance.Subtract(value)

C#

public DateTime Subtract (
    TimeSpan value
)

C++

public:
DateTime Subtract (
    TimeSpan value
)

J#

public DateTime Subtract (
    TimeSpan value
)

JScript

public function Subtract (
    value : TimeSpan
) : DateTime

パラメータ

value

TimeSpan のインスタンス。

戻り値
このインスタンスで表された日付と時刻から value で表された時間間隔を減算した値である DateTime。

例外

例外の種類	条件
ArgumentOutOfRangeException	結果が MinValue より小さい値か、MaxValue より大きい値です。

解説

このメソッドは、DateTime の値を変更しません。代わりに、この操作の結果を示す値を持つ新しい DateTime が返されます。

使用例

Subtract メソッドおよび演算子のコード例を次に示します。

Visual Basic

Dim date1 As New System.DateTime(1996,
 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996,
 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996,
 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

Dim date4 As System.DateTime
' date4 gets 4/9/1996 5:55:00 PM.
date4 = date3.Subtract(diff1)

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

C#

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15,
 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2,
 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42,
 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

C++

System::DateTime date1 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = System::DateTime( 1996, 10, 12, 8, 42, 0 );

// diff1 gets 185 days, 14 hours, and 47 minutes.
System::TimeSpan diff1 = date2.Subtract( date1 );

// date4 gets 4/9/1996 5:55:00 PM.
System::DateTime date4 = date3.Subtract( diff1 );

// diff2 gets 55 days 4 hours and 20 minutes.
System::TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System::DateTime date5 = date1 - diff2;

J#

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15,
 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2,
 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42,
 0);
// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);
// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);
// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2.Subtract(date3);
// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1.Subtract(diff2);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DateTime 構造体
DateTime メンバ
System 名前空間
TimeSpan

DateTime.Subtract メソッド

このインスタンスから指定した時刻または存続時間を減算します。
オーバーロードの一覧

名前	説明
DateTime.Subtract (DateTime)	このインスタンスから指定した日付と時刻を減算します。 .NET Compact Framework によってサポートされています。
DateTime.Subtract (TimeSpan)	このインスタンスから指定した存続時間を減算します。 .NET Compact Framework によってサポートされています。

参照

関連項目

DateTime 構造体
DateTime メンバ
System 名前空間