DateTime.Subtract Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Возвращает значение, которое приводит к вычитание указанного времени или длительности из значения этого экземпляра.

Перегрузки

Имя	Описание
Subtract(TimeSpan)	Возвращает новое DateTime значение, вычитающее указанную длительность из значения этого экземпляра.
Subtract(DateTime)	Возвращает новое TimeSpan , вычитающее указанную дату и время из значения этого экземпляра.

Subtract(TimeSpan)

Исходный код:

DateTime.cs

Возвращает новое DateTime значение, вычитающее указанную длительность из значения этого экземпляра.

public:
 DateTime Subtract(TimeSpan value);

public DateTime Subtract(TimeSpan value);

member this.Subtract : TimeSpan -> DateTime

Public Function Subtract (value As TimeSpan) As DateTime

Параметры

value

TimeSpan

Интервал времени для вычитания.

Возвращаемое значение

DateTime

Объект, равный дате и времени, представленному этим экземпляром, минус интервал времени, представленный value.

Исключения

ArgumentOutOfRangeException

Результат меньше DateTime.MinValue или больше DateTime.MaxValue.

Примеры

В следующем примере демонстрируется Subtract метод и оператор вычитания.

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)

Комментарии

Метод Subtract(TimeSpan) возвращает дату, которая является заданным интервалом времени от текущего экземпляра. Чтобы определить интервал времени между двумя датами, вызовите Subtract(DateTime) метод. Чтобы вычесть определенный интервал времени из текущего экземпляра, вызовите метод, добавляющий этот интервал времени к текущей дате, и укажите отрицательное значение в качестве аргумента метода. Например, чтобы вычитать два месяца с текущей даты, вызовите AddMonths(Int32) метод со значением -2.

Этот метод не изменяет значение этого DateTimeметода. Вместо этого он возвращает новое DateTime значение, значение которого является результатом этой операции.

Обычно DateTime.Subtract(TimeSpan) метод вычитает TimeSpan объект, представляющий положительный интервал времени, и возвращает DateTime значение, которое раньше даты и времени текущего экземпляра. Однако если TimeSpan объект представляет отрицательный интервал времени, DateTime.Subtract(TimeSpan) метод возвращает DateTime значение, которое позже даты и времени текущего экземпляра.

Этот DateTime.Subtract(TimeSpan) метод позволяет вычитать интервал времени, состоящий из нескольких единиц времени (например, заданного количества часов и заданного количества минут). Чтобы вычитать одну единицу времени (например, годы, месяцы или дни) из экземпляра DateTime , можно передать отрицательное числовое значение в качестве параметра любому из следующих методов:

• AddYears, чтобы вычитать определенное количество лет из текущего экземпляра даты и времени.

• AddMonthsДля вычитания определенного количества месяцев из текущего экземпляра даты и времени.

• AddDaysДля вычитания определенного количества дней из текущего экземпляра даты и времени.

• AddHours, чтобы вычитать определенное количество часов из текущего экземпляра даты и времени.

• AddMinutesДля вычитания определенного количества минут из текущего экземпляра даты и времени.

• AddSecondsДля вычитания определенного количества секунд из текущего экземпляра даты и времени.

• AddMilliseconds, чтобы вычитать определенное количество миллисекунд из текущего экземпляра даты и времени.

• AddTicks, чтобы вычитать определенное количество галок из текущего экземпляра даты и времени.

См. также раздел

• TimeSpan
• Выполнение арифметических операций с датами и временем

Subtract(DateTime)

Исходный код:

DateTime.cs

Возвращает новое TimeSpan , вычитающее указанную дату и время из значения этого экземпляра.

public:
 TimeSpan Subtract(DateTime value);

public TimeSpan Subtract(DateTime value);

member this.Subtract : DateTime -> TimeSpan

Public Function Subtract (value As DateTime) As TimeSpan

Параметры

value

DateTime

Значение даты и времени для вычитания.

Возвращаемое значение

TimeSpan

Интервал времени, равный дате и времени, представленному этим экземпляром, минус дата и время, представленные value.

Исключения

ArgumentOutOfRangeException

Результат меньше DateTime.MinValue или больше DateTime.MaxValue.

Примеры

В следующем примере демонстрируется Subtract метод и оператор вычитания.

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)

Комментарии

Метод Subtract(DateTime) определяет разницу между двумя датами. Чтобы вычесть интервал времени из текущего экземпляра Subtract(TimeSpan) , вызовите метод. Чтобы вычесть определенный интервал времени из текущего экземпляра, вызовите метод, добавляющий этот интервал времени к текущей дате, и укажите отрицательное значение в качестве аргумента метода. Например, чтобы вычитать два месяца с текущей даты, вызовите AddMonths(Int32) метод со значением -2.

Если дата и время текущего экземпляра раньше value, метод возвращает TimeSpan объект, представляющий отрицательный период времени. То есть значение всех его ненулевых свойств (например Days , или Ticks) является отрицательным.

Метод Subtract(DateTime) не учитывает значение Kind свойства двух DateTime значений при выполнении вычитания. Прежде чем вычитать DateTime объекты, убедитесь, что объекты представляют время в одном часовом поясе. В противном случае результат будет включать разницу между часовых поясами.

Замечание

Метод DateTimeOffset.Subtract(DateTimeOffset) учитывает разницу между часовых поясами при выполнении вычитания.

См. также раздел

• Выполнение арифметических операций с датами и временем