DateTime.Subtract Метод

Определение

Возвращает значение, полученное путем вычитания указанного времени или длительности из значения этого экземпляра.Returns the value that results from subtracting the specified time or duration from the value of this instance.

Перегрузки

Subtract(DateTime)

Возвращает новый объект TimeSpan, который вычитает из значения этого экземпляра указанную дату и время.Returns a new TimeSpan that subtracts the specified date and time from the value of this instance.

Subtract(TimeSpan)

Возвращает новый объект DateTime, который вычитает из значения этого экземпляра указанную длительность.Returns a new DateTime that subtracts the specified duration from the value of this instance.

Subtract(DateTime)

Возвращает новый объект TimeSpan, который вычитает из значения этого экземпляра указанную дату и время.Returns a new TimeSpan that subtracts the specified date and time from the value of 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

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

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

TimeSpan

Интервал времени, равный разнице между датой и временем, представленными этим экземпляром, и датой и временем, представленными параметром 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)

Возвращает новый объект DateTime, который вычитает из значения этого экземпляра указанную длительность.Returns a new DateTime that subtracts the specified duration from the value of 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

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

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

DateTime

Объект, равный разнице между датой и временем, представленными этим экземпляром, и интервалом времени, представленным параметром 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.

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

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