DateTimeOffset.Subtraction Operator

リファレンス

定義

名前空間:: System

アセンブリ:: mscorlib.dll, System.Runtime.dll

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定された DateTimeOffset オブジェクトまたは TimeSpan オブジェクトを DateTimeOffset オブジェクトから減算します。

オーバーロード

Subtraction(DateTimeOffset, DateTimeOffset)	一方の DateTimeOffset オブジェクトをもう一方のオブジェクトから減算し、時間間隔を生成します。
Subtraction(DateTimeOffset, TimeSpan)	指定した日付と時刻から指定した時間間隔を減算して、新しい日付と時刻を作成します。

Subtraction(DateTimeOffset, DateTimeOffset)

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

一方の DateTimeOffset オブジェクトをもう一方のオブジェクトから減算し、時間間隔を生成します。

public:
 static TimeSpan operator -(DateTimeOffset left, DateTimeOffset right);

public static TimeSpan operator -(DateTimeOffset left, DateTimeOffset right);

static member ( - ) : DateTimeOffset * DateTimeOffset -> TimeSpan

Public Shared Operator - (left As DateTimeOffset, right As DateTimeOffset) As TimeSpan

パラメーター

left: DateTimeOffset

被減数。

right: DateTimeOffset

減数。

戻り値

TimeSpan

left と right の差を表すオブジェクト。

注釈

メソッドは Subtraction 、オブジェクトの減算演算を DateTimeOffset 定義します。これにより、次のようなコードが有効になります。

DateTimeOffset firstDate = new DateTimeOffset(2008, 3, 25, 18, 0, 0,
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2008, 3, 25, 18, 0, 0,
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2008, 2, 28, 9, 0, 0,
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate - secondDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}",
                  firstDate.ToString(),
                  secondDate.ToString(),
                  difference.Days,
                  difference.Hours,
                  difference.Minutes);

difference = firstDate - thirdDate;
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}",
                  firstDate.ToString(),
                  thirdDate.ToString(),
                  difference.Days,
                  difference.Hours,
                  difference.Minutes);
// The example produces the following output:
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
//    (3/25/2008 6:00:00 PM -07:00) - (2/28/2008 9:00:00 AM -07:00): 26 days, 9:00

let firstDate =
    DateTimeOffset(2008, 3, 25, 18, 0, 0, TimeSpan(-7, 0, 0))

let secondDate =
    DateTimeOffset(2008, 3, 25, 18, 0, 0, TimeSpan(-5, 0, 0))

let thirdDate =
    DateTimeOffset(2008, 2, 28, 9, 0, 0, TimeSpan(-7, 0, 0))

let difference = firstDate - secondDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

let difference = firstDate - thirdDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"
// The example produces the following output:
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
//    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00

Dim firstDate As New DateTimeOffset(#3/25/2008 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#3/25/2008 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#2/28/2008 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate - secondDate
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}", _
                  firstDate.ToString(), _
                  secondDate.ToString(), _
                  difference.Days, _
                  difference.Hours, _
                  difference.Minutes)      
difference = firstDate - thirdDate
Console.WriteLine("({0}) - ({1}): {2} days, {3}:{4:d2}", _
                  firstDate.ToString(), _
                  secondDate.ToString(), _
                  difference.Days, _
                  difference.Hours, _
                  difference.Minutes) 
' The example produces the following output:
'    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 0 days, 2:00
'    (3/25/2008 6:00:00 PM -07:00) - (3/25/2008 6:00:00 PM -05:00): 26 days, 9:00

カスタム演算子と演算子のオーバーロードをサポートしていない言語では、代わりにメソッドを DateTimeOffset.Subtract(DateTimeOffset) 呼び出すことができます。

この演算子の同等のメソッドはです DateTimeOffset.Subtract(TimeSpan)。

こちらもご覧ください

適用対象

.NET 10 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Subtraction(DateTimeOffset, TimeSpan)

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

ソース:: DateTimeOffset.cs

指定した日付と時刻から指定した時間間隔を減算して、新しい日付と時刻を作成します。

public:
 static DateTimeOffset operator -(DateTimeOffset dateTimeOffset, TimeSpan timeSpan);

public:
 static DateTimeOffset operator -(DateTimeOffset dateTimeTz, TimeSpan timeSpan);

public static DateTimeOffset operator -(DateTimeOffset dateTimeOffset, TimeSpan timeSpan);

public static DateTimeOffset operator -(DateTimeOffset dateTimeTz, TimeSpan timeSpan);

static member ( - ) : DateTimeOffset * TimeSpan -> DateTimeOffset

static member ( - ) : DateTimeOffset * TimeSpan -> DateTimeOffset

Public Shared Operator - (dateTimeOffset As DateTimeOffset, timeSpan As TimeSpan) As DateTimeOffset

Public Shared Operator - (dateTimeTz As DateTimeOffset, timeSpan As TimeSpan) As DateTimeOffset

パラメーター

dateTimeOffsetdateTimeTz: DateTimeOffset

減算される日時オブジェクト。

timeSpan: TimeSpan

減算する時間間隔。

戻り値

DateTimeOffset

dateTimeOffset から timeSpan を減算した値と等しいオブジェクト。

例外

ArgumentOutOfRangeException

結果 DateTimeOffset の値が DateTimeOffset.MinValue より小さいか、 DateTimeOffset.MaxValue より大きくなります。

注釈

メソッドは Subtraction 、オブジェクトの減算演算を DateTimeOffset 定義します。これにより、次のようなコードが有効になります。

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0,
                               new TimeSpan(-8, 0, 0));
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate - duration);  // Displays 11/25/2007 5:30:00 PM -08:00

let offsetDate =
    DateTimeOffset(2007, 12, 3, 11, 30, 0, TimeSpan(-8, 0, 0))

let duration = TimeSpan(7, 18, 0, 0)
printfn $"{offsetDate - duration}" // Displays 11/25/2007 5:30:00 PM -08:00

Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate - duration)    ' Displays 11/25/2007 5:30:00 PM -08:00

カスタム演算子と演算子のオーバーロードをサポートしていない言語では、代わりにメソッドを DateTimeOffset.Subtract(TimeSpan) 呼び出すことができます。

この演算子の同等のメソッドはです DateTimeOffset.Subtract(TimeSpan)。

こちらもご覧ください

適用対象

.NET 10 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

次の方法で共有

DateTimeOffset.Subtraction Operator

定義

オーバーロード

Subtraction(DateTimeOffset, DateTimeOffset)

パラメーター

戻り値

注釈

こちらもご覧ください

適用対象

Subtraction(DateTimeOffset, TimeSpan)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

その他のリソース