DateTime.Subtract Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Vrátí hodnotu, která je výsledkem odečtení zadaného času nebo doby trvání od hodnoty této instance.

Přetížení

Subtract(TimeSpan)

Vrátí nový DateTime , který odečte zadanou dobu trvání od hodnoty této instance.
Subtract(DateTime)

Vrátí nový TimeSpan , který odečte zadané datum a čas od hodnoty této instance.

Subtract(TimeSpan)

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

Vrátí nový DateTime , který odečte zadanou dobu trvání od hodnoty této instance.

public:
 DateTime Subtract(TimeSpan value);
public DateTime Subtract (TimeSpan value);
member this.Subtract : TimeSpan -> DateTime
Public Function Subtract (value As TimeSpan) As DateTime

Parametry

value
TimeSpan

Časový interval, který chcete odečíst.

Návraty

DateTime

Objekt, který je roven datu a času reprezentovaným touto instancí minus časový interval reprezentovaný hodnotou value.

Výjimky

ArgumentOutOfRangeException

Výsledek je menší než DateTime.MinValue nebo větší než DateTime.MaxValue.

Příklady

Následující příklad ukazuje metodu Subtract a operátor odčítání.

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;

open System

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

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

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

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;

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)

Poznámky

Metoda Subtract(TimeSpan) vrátí datum, které je zadaným rozdílem časového intervalu od aktuální instance. Pokud chcete určit časový interval mezi dvěma daty, zavolejte metodu Subtract(DateTime) . Chcete-li odečíst určitý časový interval od aktuální instance, zavolejte metodu, která tento časový interval přidá k aktuálnímu datu a jako argument metody zadá zápornou hodnotu. Pokud chcete například odečíst dva měsíce od aktuálního data, zavolejte metodu AddMonths(Int32) s hodnotou -2.

Tato metoda nezmění hodnotu této DateTimemetody . Místo toho vrátí novou DateTime hodnotu, jejíž hodnota je výsledkem této operace.

Metoda obvykle odečítá TimeSpan objekt, DateTime.Subtract(TimeSpan) který představuje kladné časové rozpětí, a vrátí DateTime hodnotu, která je starší než datum a čas aktuální instance. Pokud TimeSpan však objekt představuje záporný časový rozsah, DateTime.Subtract(TimeSpan) vrátí DateTime metoda hodnotu, která je pozdější než datum a čas aktuální instance.

Metoda DateTime.Subtract(TimeSpan) umožňuje odečíst časový interval, který se skládá z více než jedné časové jednotky (například určitý počet hodin a zadaný počet minut). Pokud chcete od DateTime instance odečíst jednu jednotku času (například roky, měsíce nebo dny), můžete předat zápornou číselnou hodnotu jako parametr některé z následujících metod:

  • AddYearspro odečtení určitého počtu let od aktuální instance data a času.

  • AddMonths, pokud chcete odečíst konkrétní počet měsíců od aktuální instance data a času.

  • AddDayspro odečtení určitého počtu dnů od aktuální instance data a času.

  • AddHourspro odečtení určitého počtu hodin od aktuální instance data a času.

  • AddMinutes, aby se odečetl konkrétní počet minut od aktuální instance data a času.

  • AddSecondspro odečtení určitého počtu sekund od aktuální instance data a času.

  • AddMilliseconds, aby se odečítal určitý počet milisekund od aktuální instance data a času.

  • AddTickspro odečtení určitého počtu odškrtávek od aktuální instance data a času.

Viz také

Platí pro

Subtract(DateTime)

Source:
DateTime.cs
Source:
DateTime.cs
Source:
DateTime.cs

Vrátí nový TimeSpan , který odečte zadané datum a čas od hodnoty této instance.

public:
 TimeSpan Subtract(DateTime value);
public TimeSpan Subtract (DateTime value);
member this.Subtract : DateTime -> TimeSpan
Public Function Subtract (value As DateTime) As TimeSpan

Parametry

value
DateTime

Hodnota data a času, která se má odečíst.

Návraty

TimeSpan

Časový interval, který se rovná datu a času reprezentovaným touto instancí minus datum a čas reprezentovaný hodnotou value.

Výjimky

ArgumentOutOfRangeException

Výsledek je menší než DateTime.MinValue nebo větší než DateTime.MaxValue.

Příklady

Následující příklad ukazuje metodu Subtract a operátor odčítání.

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;

open System

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

// diff1 gets 185 days, 14 hours, and 47 minutes.
let diff1 = date2.Subtract date1

// date4 gets 4/9/1996 5:55:00 PM.
let date4 = date3.Subtract diff1

// diff2 gets 55 days 4 hours and 20 minutes.
let diff2 = date2 - date3

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

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;

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)

Poznámky

Metoda Subtract(DateTime) určuje rozdíl mezi dvěma daty. Pokud chcete odečíst časový interval od aktuální instance, zavolejte metodu Subtract(TimeSpan) . Chcete-li odečíst určitý časový interval od aktuální instance, zavolejte metodu, která tento časový interval přidá k aktuálnímu datu a jako argument metody zadá zápornou hodnotu. Pokud chcete například odečíst dva měsíce od aktuálního data, zavolejte metodu AddMonths(Int32) s hodnotou -2.

Pokud je datum a čas aktuální instance dřívější než value, vrátí TimeSpan metoda objekt, který představuje záporný časový rozsah. To znamená, že hodnota všech jeho nenulových vlastností (například Days nebo Ticks) je záporná.

Metoda Subtract(DateTime) při provádění odčítání nebere v úvahu hodnotu Kind vlastnosti těchto dvou DateTime hodnot. Před odečtením DateTime objektů se ujistěte, že objekty představují časy ve stejném časovém pásmu. V opačném případě bude výsledek zahrnovat rozdíl mezi časovými pásmy.

Poznámka

Metoda DateTimeOffset.Subtract(DateTimeOffset) při provádění odčítání bere v úvahu rozdíl mezi časovými pásmy.

Viz také

Platí pro