次の方法で共有


DateTimeOffset.Subtraction Operator

定義

指定された 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

減数。

戻り値

leftright の差を表すオブジェクト。

注釈

メソッドは 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)

こちらもご覧ください

適用対象

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 から timeSpan を減算した値と等しいオブジェクト。

例外

結果 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)

こちらもご覧ください

適用対象