DateTimeOffset.Subtraction Operator

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

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

オーバーロード

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

Subtraction(DateTimeOffset, DateTimeOffset)

ソース:

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)。

こちらもご覧ください

• Subtract(DateTimeOffset)
• 日付と時刻を使用した算術演算の実行

Subtraction(DateTimeOffset, TimeSpan)

ソース:

DateTimeOffset.cs

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

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

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

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

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

パラメーター

dateTimeOffset

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)。

こちらもご覧ください

• Subtract(TimeSpan)
• 日付と時刻を使用した算術演算の実行