DateTime.Subtract DateTime.Subtract DateTime.Subtract DateTime.Subtract Method

Определение

Вычитает из этого экземпляра указанное время или длительность. Subtracts the specified time or duration from this instance.

Перегрузки

Subtract(DateTime) Subtract(DateTime) Subtract(DateTime) Subtract(DateTime)

Вычитает из этого экземпляра указанную дату и время. Subtracts the specified date and time from this instance.

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Вычитает из этого экземпляра указанную длительность. Subtracts the specified duration from this instance.

Subtract(DateTime) Subtract(DateTime) Subtract(DateTime) Subtract(DateTime)

Вычитает из этого экземпляра указанную дату и время. Subtracts the specified date and time from this instance.

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 DateTime DateTime DateTime

Вычитаемые дата и время. The date and time value to subtract.

Возвраты

Интервал времени, равный разнице между датой и временем, представленными этим экземпляром, и датой и временем, представленными параметром value. A time interval that is equal to the date and time represented by this instance minus the date and time represented by value.

Исключения

Результат меньше MinValue или больше MaxValue. The result is less than MinValue or greater than MaxValue.

Примеры

В следующем примере демонстрируется Subtract метода и оператор вычитания.The following example demonstrates the Subtract method and the subtraction operator.

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;
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) Метод определяет разницу между двумя датами.The Subtract(DateTime) method determines the difference between two dates. Вычитаемый интервал времени из текущего экземпляра, вызовите Subtract(TimeSpan) метод.To subtract a time interval from the current instance, call the Subtract(TimeSpan) method. Чтобы вычесть указанный интервал времени из текущего экземпляра, вызовите метод, который добавляет этого интервала времени до текущей даты и предоставьте отрицательное значение в качестве аргумента метода.To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. Например, чтобы вычесть два месяца от текущей даты, вызовите AddMonths(Int32) метод со значением от -2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Если дата и время текущего экземпляра более ранняя, чем value, метод возвращает TimeSpan , представляющий отрицательный временной промежуток.If the date and time of the current instance is earlier than value, the method returns a TimeSpan object that represents a negative time span. То есть значение все его ненулевое значение свойства (такие как Days или Ticks) является отрицательным.That is, the value of all of its non-zero properties (such as Days or Ticks) is negative.

Subtract(DateTime) Метод не учитывает значение Kind свойства двух DateTime значения при выполнении операции вычитания.The Subtract(DateTime) method does not consider the value of the Kind property of the two DateTime values when performing the subtraction. До вычитания DateTime объектов, убедитесь, что они представляют время, в том же часовом поясе.Before subtracting DateTime objects, ensure that the objects represent times in the same time zone. В противном случае результат будет включать разницу между часовыми поясами.Otherwise, the result will include the difference between time zones.

Примечание

DateTimeOffset.Subtract(DateTimeOffset) Метод Обратите внимание на разницу между часовыми поясами, при выполнении операции вычитания.The DateTimeOffset.Subtract(DateTimeOffset) method does consider the difference between time zones when performing the subtraction.

См. также

Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan) Subtract(TimeSpan)

Вычитает из этого экземпляра указанную длительность. Subtracts the specified duration from this instance.

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 TimeSpan TimeSpan TimeSpan

Вычитаемый интервал времени. The time interval to subtract.

Возвраты

Объект, равный разнице между датой и временем, представленными этим экземпляром, и интервалом времени, представленным параметром value. An object that is equal to the date and time represented by this instance minus the time interval represented by value.

Исключения

Результат меньше MinValue или больше MaxValue. The result is less than MinValue or greater than MaxValue.

Примеры

В следующем примере демонстрируется Subtract метода и оператор вычитания.The following example demonstrates the Subtract method and the subtraction operator.

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;
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) Метод возвращает дату на указанное время интервала отличие от текущего экземпляра.The Subtract(TimeSpan) method returns the date that is a specified time interval difference from the current instance. Чтобы определить интервал времени между двумя датами, вызовите Subtract(DateTime) метод.To determine the time interval between two dates, call the Subtract(DateTime) method. Чтобы вычесть указанный интервал времени из текущего экземпляра, вызовите метод, который добавляет этого интервала времени до текущей даты и предоставьте отрицательное значение в качестве аргумента метода.To subtract a particular time interval from the current instance, call the method that adds that time interval to the current date, and supply a negative value as the method argument. Например, чтобы вычесть два месяца от текущей даты, вызовите AddMonths(Int32) метод со значением от -2.For example, to subtract two months from the current date, call the AddMonths(Int32) method with a value of -2.

Этот метод не изменяет значение этой DateTime.This method does not change the value of this DateTime. Вместо этого он возвращает новый DateTime , значение которого является результатом этой операции.Instead, it returns a new DateTime whose value is the result of this operation.

Как правило DateTime.Subtract(TimeSpan) метод вычитает TimeSpan объект, представляющий положительный период времени и возвращает DateTime значение, более ранняя, чем дата и время текущего экземпляра.Ordinarily, the DateTime.Subtract(TimeSpan) method subtracts a TimeSpan object that represents a positive time span and returns a DateTime value that is earlier than the date and time of the current instance. Тем не менее если TimeSpan представляет отрицательный временной промежуток, DateTime.Subtract(TimeSpan) возвращает DateTime значение, более поздней, чем дата и время текущего экземпляра.However, if the TimeSpan object represents a negative time span, the DateTime.Subtract(TimeSpan) method returns a DateTime value that is later than the date and time of the current instance.

DateTime.Subtract(TimeSpan) Метод позволяет вычесть интервал времени, состоящая из более чем одной единицы времени, например (заданного числа часов) и заданного числа минут.The DateTime.Subtract(TimeSpan) method allows you to subtract a time interval that consists of more than one unit of time (such as a given number of hours and a given number of minutes). Чтобы вычесть одну единицу времени (например, годы, месяцы или дни) из DateTime экземпляр, можно передать отрицательное числовое значение как параметр в любой из следующих методов:To subtract a single unit of time (such as years, months, or days) from the DateTime instance, you can pass a negative numeric value as a parameter to any of the following methods:

  • AddYears, вычитаемый определенное количество лет от текущего экземпляра даты и времени.AddYears, to subtract a specific number of years from the current date and time instance.

  • AddMonths, вычитаемый определенное количество месяцев от текущего экземпляра даты и времени.AddMonths, to subtract a specific number of months from the current date and time instance.

  • AddDays, вычитаемый определенное число дней от текущего экземпляра даты и времени.AddDays, to subtract a specific number of days from the current date and time instance.

  • AddHours, вычитаемый определенное количество часов от текущего экземпляра даты и времени.AddHours, to subtract a specific number of hours from the current date and time instance.

  • AddMinutes, вычитаемый определенное число минут от текущего экземпляра даты и времени.AddMinutes, to subtract a specific number of minutes from the current date and time instance.

  • AddSeconds, вычитаемый определенное количество секунд от текущего экземпляра даты и времени.AddSeconds, to subtract a specific number of seconds from the current date and time instance.

  • AddMilliseconds, вычитаемый определенное количество миллисекунд из текущего экземпляра даты и времени.AddMilliseconds, to subtract a specific number of milliseconds from the current date and time instance.

  • AddTicks, вычитаемый определенное количество тактов, из текущего экземпляра даты и времени.AddTicks, to subtract a specific number of ticks from the current date and time instance.

См. также

Применяется к