DateAndTime.DateAdd Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Date Возвращает значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени.
Перегрузки
| Имя | Описание |
|---|---|
| DateAdd(DateInterval, Double, DateTime) |
Возвращает значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени. |
| DateAdd(String, Double, Object) |
Возвращает значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени. |
DateAdd(DateInterval, Double, DateTime)
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
Возвращает значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени.
public:
static DateTime DateAdd(Microsoft::VisualBasic::DateInterval Interval, double Number, DateTime DateValue);public static DateTime DateAdd(Microsoft.VisualBasic.DateInterval Interval, double Number, DateTime DateValue);static member DateAdd : Microsoft.VisualBasic.DateInterval * double * DateTime -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimeПараметры
- Interval
- DateInterval
Обязательно. DateInterval Значение перечисления или строковое выражение, представляющее интервал времени, который требуется добавить.
- Number
- Double
Обязательно. Выражение с плавающей запятой, представляющее количество интервалов, которые необходимо добавить. Он может быть положительным (для получения значений даты и времени в будущем) или отрицательных (для получения значений даты и времени в прошлом). Она может содержать дробную часть при Interval указании часов, минут или секунд. Для других значений Intervalлюбая дробная часть Number игнорируется.
- DateValue
- DateTime
Обязательно. Выражение, представляющее дату и время добавления интервала.
DateValue Сам по себе не изменяется в вызывающей программе.
Возвращаемое значение
Значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени.
Исключения
DateValue не является принудительным для Date.
Interval недопустимо.
Вычисляемая дата до 00:00:00 1 января 1 года или более 23:59:59 31 декабря 9999 года.
Примеры
Этот пример принимает дату и, используя DateAdd функцию, отображает соответствующую дату указанного числа месяцев в будущем.
Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")
Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)
' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)
' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)
MessageBox.Show("New date: " & newDate.ToShortDateString)
Комментарии
Функцию DateAdd можно использовать для добавления или вычитания указанного интервала времени с даты. Например, можно вычислить дату 30 дней с сегодняшнего дня или 45 минут до этого.
Чтобы добавить дни DateValueв , можно использовать DateInterval.Dayили DateInterval.DayOfYearDateInterval.Weekday. Они рассматриваются как эквивалентные, так как DayOfYear и Weekday не являются значимыми интервалами времени.
Функция DateAdd никогда не возвращает недопустимую дату. При необходимости часть итоговой даты корректируется вниз до последнего дня результирующего месяца в результирующем году. В следующем примере к 31 января прибавляется 1 месяц:
Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)
В этом примере DateAdd возвращается #2/28/1995#, а не #2/31/1995#. Если DateValue есть #1/31/1996#, он возвращается #2/29/1996# , потому что 1996 год високосный год.
Замечание
DateAddиспользует текущий параметр календаря CultureInfo из CurrentCulture свойства класса в System.Globalization пространстве имен. Значения по умолчанию CurrentCulture определяются параметрами панели управления .
Так как каждое Date значение поддерживается структурой DateTime , его методы предоставляют дополнительные параметры при добавлении интервалов времени. Например, можно добавить дробное число дней, округленное до ближайшего миллисекунда, в Date переменную следующим образом:
Dim NextTime As Date = Now ' Current date and time.
NextTime = NextTime.AddDays(3.4) ' Increment by 3 2/5 days.
Аргумент Interval может иметь один из следующих параметров.
| Значение перечисления | String | Единица времени для добавления |
|---|---|---|
DateInterval.Day |
d | День; усечено до целочисленного значения |
DateInterval.DayOfYear |
и | День; усечено до целочисленного значения |
DateInterval.Hour |
ч | Час; округлено до ближайшей миллисекунда |
DateInterval.Minute |
н | Минуту; округлено до ближайшей миллисекунда |
DateInterval.Month |
m | Месяц; усечено до целочисленного значения |
DateInterval.Quarter |
q | Квартал; усечено до целочисленного значения |
DateInterval.Second |
s | Второй; округлено до ближайшей миллисекунда |
DateInterval.Weekday |
w | День; усечено до целочисленного значения |
DateInterval.WeekOfYear |
ww | Неделю; усечено до целочисленного значения |
DateInterval.Year |
yyyy | Год; усечено до целочисленного значения |
См. также раздел
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Сводка по типу данных (Visual Basic)
Применяется к
DateAdd(String, Double, Object)
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
Возвращает значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени.
public:
static DateTime DateAdd(System::String ^ Interval, double Number, System::Object ^ DateValue);public static DateTime DateAdd(string Interval, double Number, object? DateValue);public static DateTime DateAdd(string Interval, double Number, object DateValue);static member DateAdd : string * double * obj -> DateTimePublic Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTimeПараметры
- Interval
- String
Обязательно. DateInterval Значение перечисления или строковое выражение, представляющее интервал времени, который требуется добавить.
- Number
- Double
Обязательно. Выражение с плавающей запятой, представляющее количество интервалов, которые необходимо добавить.
Number может быть положительным (для получения значений даты и времени в будущем) или отрицательных (для получения значений даты и времени в прошлом). Она может содержать дробную часть при Interval указании часов, минут или секунд. Для других значений Intervalлюбая дробная часть Number игнорируется.
- DateValue
- Object
Обязательно. Выражение, представляющее дату и время добавления интервала.
DateValue Сам по себе не изменяется в вызывающей программе.
Возвращаемое значение
Значение, содержащее значение даты и времени, к которому был добавлен указанный интервал времени.
Исключения
DateValue не является принудительным для Date.
Interval недопустимо.
Вычисляемая дата до 00:00:00 1 января 1 года или более 23:59:59 31 декабря 9999 года.
Примеры
Этот пример принимает дату и, используя DateAdd функцию, отображает соответствующую дату указанного числа месяцев в будущем.
Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")
Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)
' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)
' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)
MessageBox.Show("New date: " & newDate.ToShortDateString)
Комментарии
Функцию DateAdd можно использовать для добавления или вычитания указанного интервала времени с даты. Например, можно вычислить дату 30 дней с сегодняшнего дня или 45 минут до этого.
Чтобы добавить дни DateValueв , можно использовать DateInterval.Dayили DateInterval.DayOfYearDateInterval.Weekday. Они рассматриваются как эквивалентные, так как DayOfYear и Weekday не являются значимыми интервалами времени.
Функция DateAdd никогда не возвращает недопустимую дату. При необходимости часть итоговой даты корректируется вниз до последнего дня результирующего месяца в результирующем году. В следующем примере к 31 января прибавляется 1 месяц:
Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)
В этом примере DateAdd возвращается #2/28/1995#, а не #2/31/1995#. Если DateValue есть #1/31/1996#, он возвращается #2/29/1996# , потому что 1996 год високосный год.
Замечание
DateAddиспользует текущий параметр календаря CultureInfo из CurrentCulture свойства класса в System.Globalization пространстве имен. Значения по умолчанию CurrentCulture определяются параметрами панели управления .
Так как каждое Date значение поддерживается структурой DateTime , его методы предоставляют дополнительные параметры при добавлении интервалов времени. Например, можно добавить дробное число дней, округленное до ближайшего миллисекунда, в Date переменную следующим образом:
Dim NextTime As Date = Now ' Current date and time.
NextTime = NextTime.AddDays(3.4) ' Increment by 3 2/5 days.
Аргумент Interval может иметь один из следующих параметров.
| Значение перечисления | String | Единица времени для добавления |
|---|---|---|
DateInterval.Day |
d | День; усечено до целочисленного значения |
DateInterval.DayOfYear |
и | День; усечено до целочисленного значения |
DateInterval.Hour |
ч | Час; округлено до ближайшей миллисекунда |
DateInterval.Minute |
н | Минуту; округлено до ближайшей миллисекунда |
DateInterval.Month |
m | Месяц; усечено до целочисленного значения |
DateInterval.Quarter |
q | Квартал; усечено до целочисленного значения |
DateInterval.Second |
s | Второй; округлено до ближайшей миллисекунда |
DateInterval.Weekday |
w | День; усечено до целочисленного значения |
DateInterval.WeekOfYear |
ww | Неделю; усечено до целочисленного значения |
DateInterval.Year |
yyyy | Год; усечено до целочисленного значения |
См. также раздел
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Сводка по типу данных (Visual Basic)
