DateTime.Subtract Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.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í

Name	Description
Subtract(TimeSpan)	Vrátí novou DateTime hodnotu, která odečte zadanou dobu trvání od hodnoty této instance.
Subtract(DateTime)	Vrátí novou TimeSpan hodnotu, která odečte zadané datum a čas od hodnoty této instance.

Subtract(TimeSpan)

Zdroj:

DateTime.cs

Vrátí novou DateTime hodnotu, 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ý se má odečíst.

Návraty

DateTime

Objekt, který se rovná datu a času reprezentované touto instancí minus časový interval reprezentovaný 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í.

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ý časový interval rozdíl od aktuální instance. Pokud chcete určit časový interval mezi dvěma daty, zavolejte metodu Subtract(DateTime) . Pokud chcete odečíst konkrétní časový interval od aktuální instance, zavolejte metodu, která tento časový interval přidá k aktuálnímu datu, a jako argument metody zadejte zápornou hodnotu. Pokud například chcete odečíst dva měsíce od aktuálního data, zavolejte metodu AddMonths(Int32) s hodnotou -2.

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

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

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

• AddYears, pro odečtení určitého počtu roků od aktuální instance data a času.

• AddMonths, pro odečtení určitého počtu měsíců od aktuální instance data a času.

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

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

• AddMinutes, pro odečtení určitého počtu minut od aktuální instance data a času.

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

• AddMilliseconds, pro odečtení určitého počtu milisekund od aktuální instance data a času.

• AddTicks, pro odečtení určitého počtu z aktuální instance data a času.

Viz také

• TimeSpan
• Provádění aritmetických operací s daty a časy

Subtract(DateTime)

Zdroj:

DateTime.cs

Vrátí novou TimeSpan hodnotu, 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ý je roven datu a času reprezentovaným touto instancí minus datum a čas reprezentovaný 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í.

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 kalendářními daty. Pokud chcete odečíst časový interval od aktuální instance, zavolejte metodu Subtract(TimeSpan) . Pokud chcete odečíst konkrétní časový interval od aktuální instance, zavolejte metodu, která tento časový interval přidá k aktuálnímu datu, a jako argument metody zadejte zápornou hodnotu. Pokud například chcete 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, metoda vrátí TimeSpan objekt, který představuje záporné časové rozpětí. To znamená, že hodnota všech nenulových vlastností (například Days ) Ticksje 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ů zajistěte, aby objekty představovaly časy ve stejném časovém pásmu. Jinak výsledek bude obsahovat rozdíl mezi časovými pásmy.

Poznámka:

Metoda DateTimeOffset.Subtract(DateTimeOffset) při provádění odčítání považuje rozdíl mezi časovými pásmy.

Viz také

• Provádění aritmetických operací s daty a časy