DateAndTime.DateAdd DateAndTime.DateAdd DateAndTime.DateAdd DateAndTime.DateAdd Method

Definición

Devuelve un valor de Date que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.Returns a Date value containing a date and time value to which a specified time interval has been added.

Sobrecargas

DateAdd(DateInterval, Double, DateTime) DateAdd(DateInterval, Double, DateTime) DateAdd(DateInterval, Double, DateTime) DateAdd(DateInterval, Double, DateTime)

Devuelve un valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.Returns a value containing a date and time value to which a specified time interval has been added.

DateAdd(String, Double, Object) DateAdd(String, Double, Object) DateAdd(String, Double, Object) DateAdd(String, Double, Object)

Devuelve un valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.Returns a value containing a date and time value to which a specified time interval has been added.

DateAdd(DateInterval, Double, DateTime) DateAdd(DateInterval, Double, DateTime) DateAdd(DateInterval, Double, DateTime) DateAdd(DateInterval, Double, DateTime)

Devuelve un valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.Returns a value containing a date and time value to which a specified time interval has been added.

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 -> DateTime
Public Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTime

Parámetros

Interval
DateInterval DateInterval DateInterval DateInterval

Obligatorio.Required. Valor de enumeración DateInterval o expresión de cadena que representa el intervalo de tiempo que se desea sumar.A DateInterval enumeration value or a string expression representing the time interval you want to add.

Number
Double Double Double Double

Obligatorio.Required. Expresión de punto flotante que representa el número de intervalos que se desea sumar.Floating-point expression representing the number of intervals you want to add. Puede ser positivo (para obtener valores de fecha y hora futuros) o negativo (para obtener valores de fecha y hora del pasado).It can be positive (to get date/time values in the future) or negative (to get date/time values in the past). Puede contener una parte fraccionaria cuando Interval especifica horas, minutos o segundos.It can contain a fractional part when Interval specifies hours, minutes, or seconds. Para otros valores de Interval, se omite cualquier parte fraccionaria de Number.For other values of Interval, any fractional part of Number is ignored.

DateValue
DateTime DateTime DateTime DateTime

Obligatorio.Required. Una expresión que representa la fecha y la hora a las que se va a sumar el intervalo.An expression representing the date and time to which the interval is to be added. DateValue no se cambia en el programa que realiza la llamada.DateValue itself is not changed in the calling program.

Devoluciones

Valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.A value containing a date and time value to which a specified time interval has been added.

Excepciones

DateValue no está establecido en Date.DateValue is not coercible to Date.

Interval no es válido.Interval is not valid.

La fecha calculada es anterior a las 00:00:00 horas del 1 de enero del año 1 o posterior a las 23:59:59 del 31 de diciembre de 9999.Calculated date is before 00:00:00 on January 1 of the year 1, or later than 23:59:59 on December 31, 9999.

Ejemplos

En este ejemplo se toma una fecha y, DateAdd con la función, se muestra una fecha correspondiente a un número especificado de meses en el futuro.This example takes a date and, using the DateAdd function, displays a corresponding date a specified number of months in the future.

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)

Comentarios

Puede utilizar la DateAdd función para agregar o restar un intervalo de tiempo especificado a partir de una fecha.You can use the DateAdd function to add or subtract a specified time interval from a date. Por ejemplo, puede calcular una fecha de 30 días a partir de hoy o una hora de 45 minutos antes de ahora.For example, you can calculate a date 30 days from today or a time 45 minutes before now.

Para agregar días a DateValue, puede usar DateInterval.Day, DateInterval.DayOfYearo DateInterval.Weekday.To add days to DateValue, you can use DateInterval.Day, DateInterval.DayOfYear, or DateInterval.Weekday. Se tratan como equivalentes porque DayOfYear y Weekday no son intervalos de tiempo significativos.These are treated as equivalent because DayOfYear and Weekday are not meaningful time intervals.

La DateAdd función nunca devuelve una fecha no válida.The DateAdd function never returns an invalid date. Si es necesario, la parte del día de la fecha resultante se ajusta hacia abajo hasta el último día del mes resultante en el año resultante.If necessary, the day part of the resulting date is adjusted downward to the last day of the resulting month in the resulting year. En el siguiente ejemplo se agrega un mes al 31 de enero:The following example adds one month to January 31:

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)  

En este ejemplo, DateAdd devuelve #2/28/1995#, no #2/31/1995#.In this example, DateAdd returns #2/28/1995#, not #2/31/1995#. Si DateValue es #1/31/1996#, devuelve#2/29/1996# porque 1996 es un año bisiesto.If DateValue is #1/31/1996#, it returns #2/29/1996# because 1996 is a leap year.

Nota

DateAddusa la configuración de calendario actual de CurrentCulture la propiedad de CultureInfo la clase en System.Globalization el espacio de nombres.DateAdd uses the current calendar setting from the CurrentCulture property of the CultureInfo class in the System.Globalization namespace. Los valores CurrentCulture predeterminados se determinan mediante la configuración del Panel de control .The default CurrentCulture values are determined by Control Panel settings.

Dado que Date cada valor es compatible con DateTime una estructura, sus métodos proporcionan opciones adicionales para agregar intervalos de tiempo.Since every Date value is supported by a DateTime structure, its methods give you additional options in adding time intervals. Por ejemplo, puede Agregar un número fraccionario de días, redondeado al milisegundo más cercano, a una Date variable como se indica a continuación:For example, you can add a fractional number of days, rounded to the nearest millisecond, to a Date variable as follows:

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.  

El Interval argumento puede tener una de las siguientes opciones.The Interval argument can have one of the following settings.

Valor de enumeraciónEnumeration value StringString Unidad de intervalo de tiempo que se va a agregarUnit of time interval to add
DateInterval.Day dd Diariamente truncado en valor enteroDay; truncated to integral value
DateInterval.DayOfYear yy Diariamente truncado en valor enteroDay; truncated to integral value
DateInterval.Hour hh Tarifa redondeado al milisegundo más cercanoHour; rounded to nearest millisecond
DateInterval.Minute nn Queda redondeado al milisegundo más cercanoMinute; rounded to nearest millisecond
DateInterval.Month mm Mensuales truncado en valor enteroMonth; truncated to integral value
DateInterval.Quarter qq Pilar truncado en valor enteroQuarter; truncated to integral value
DateInterval.Second ss Second redondeado al milisegundo más cercanoSecond; rounded to nearest millisecond
DateInterval.Weekday sw Diariamente truncado en valor enteroDay; truncated to integral value
DateInterval.WeekOfYear wwww Quincenal truncado en valor enteroWeek; truncated to integral value
DateInterval.Year yyyyyyyy Anual truncado en valor enteroYear; truncated to integral value
Consulte también:

DateAdd(String, Double, Object) DateAdd(String, Double, Object) DateAdd(String, Double, Object) DateAdd(String, Double, Object)

Devuelve un valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.Returns a value containing a date and time value to which a specified time interval has been added.

public:
 static DateTime DateAdd(System::String ^ Interval, double Number, System::Object ^ DateValue);
public static DateTime DateAdd (string Interval, double Number, object DateValue);
static member DateAdd : string * double * obj -> DateTime
Public Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTime

Parámetros

Interval
String String String String

Obligatorio.Required. Valor de enumeración DateInterval o expresión de cadena que representa el intervalo de tiempo que se desea sumar.A DateInterval enumeration value or a string expression representing the time interval you want to add.

Number
Double Double Double Double

Obligatorio.Required. Expresión de punto flotante que representa el número de intervalos que se desea sumar.Floating-point expression representing the number of intervals you want to add. Number puede ser positivo (para obtener valores de fecha y hora futuros) o negativo (para obtener valores de fecha y hora del pasado).Number can be positive (to get date/time values in the future) or negative (to get date/time values in the past). Puede contener una parte fraccionaria cuando Interval especifica horas, minutos o segundos.It can contain a fractional part when Interval specifies hours, minutes, or seconds. Para otros valores de Interval, se omite cualquier parte fraccionaria de Number.For other values of Interval, any fractional part of Number is ignored.

DateValue
Object Object Object Object

Obligatorio.Required. Una expresión que representa la fecha y la hora a las que se va a sumar el intervalo.An expression representing the date and time to which the interval is to be added. DateValue no se cambia en el programa que realiza la llamada.DateValue itself is not changed in the calling program.

Devoluciones

Valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.A value containing a date and time value to which a specified time interval has been added.

Excepciones

DateValue no está establecido en Date.DateValue is not coercible to Date.

Interval no es válido.Interval is not valid.

La fecha calculada es anterior a las 00:00:00 horas del 1 de enero del año 1 o posterior a las 23:59:59 del 31 de diciembre de 9999.Calculated date is before 00:00:00 on January 1 of the year 1, or later than 23:59:59 on December 31, 9999.

Ejemplos

En este ejemplo se toma una fecha y, DateAdd con la función, se muestra una fecha correspondiente a un número especificado de meses en el futuro.This example takes a date and, using the DateAdd function, displays a corresponding date a specified number of months in the future.

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)

Comentarios

Puede utilizar la DateAdd función para agregar o restar un intervalo de tiempo especificado a partir de una fecha.You can use the DateAdd function to add or subtract a specified time interval from a date. Por ejemplo, puede calcular una fecha de 30 días a partir de hoy o una hora de 45 minutos antes de ahora.For example, you can calculate a date 30 days from today or a time 45 minutes before now.

Para agregar días a DateValue, puede usar DateInterval.Day, DateInterval.DayOfYearo DateInterval.Weekday.To add days to DateValue, you can use DateInterval.Day, DateInterval.DayOfYear, or DateInterval.Weekday. Se tratan como equivalentes porque DayOfYear y Weekday no son intervalos de tiempo significativos.These are treated as equivalent because DayOfYear and Weekday are not meaningful time intervals.

La DateAdd función nunca devuelve una fecha no válida.The DateAdd function never returns an invalid date. Si es necesario, la parte del día de la fecha resultante se ajusta hacia abajo hasta el último día del mes resultante en el año resultante.If necessary, the day part of the resulting date is adjusted downward to the last day of the resulting month in the resulting year. En el siguiente ejemplo se agrega un mes al 31 de enero:The following example adds one month to January 31:

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)  

En este ejemplo, DateAdd devuelve #2/28/1995#, no #2/31/1995#.In this example, DateAdd returns #2/28/1995#, not #2/31/1995#. Si DateValue es #1/31/1996#, devuelve#2/29/1996# porque 1996 es un año bisiesto.If DateValue is #1/31/1996#, it returns #2/29/1996# because 1996 is a leap year.

Nota

DateAddusa la configuración de calendario actual de CurrentCulture la propiedad de CultureInfo la clase en System.Globalization el espacio de nombres.DateAdd uses the current calendar setting from the CurrentCulture property of the CultureInfo class in the System.Globalization namespace. Los valores CurrentCulture predeterminados se determinan mediante la configuración del Panel de control .The default CurrentCulture values are determined by Control Panel settings.

Dado que Date cada valor es compatible con DateTime una estructura, sus métodos proporcionan opciones adicionales para agregar intervalos de tiempo.Since every Date value is supported by a DateTime structure, its methods give you additional options in adding time intervals. Por ejemplo, puede Agregar un número fraccionario de días, redondeado al milisegundo más cercano, a una Date variable como se indica a continuación:For example, you can add a fractional number of days, rounded to the nearest millisecond, to a Date variable as follows:

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.  

El Interval argumento puede tener una de las siguientes opciones.The Interval argument can have one of the following settings.

Valor de enumeraciónEnumeration value StringString Unidad de intervalo de tiempo que se va a agregarUnit of time interval to add
DateInterval.Day dd Diariamente truncado en valor enteroDay; truncated to integral value
DateInterval.DayOfYear yy Diariamente truncado en valor enteroDay; truncated to integral value
DateInterval.Hour hh Tarifa redondeado al milisegundo más cercanoHour; rounded to nearest millisecond
DateInterval.Minute nn Queda redondeado al milisegundo más cercanoMinute; rounded to nearest millisecond
DateInterval.Month mm Mensuales truncado en valor enteroMonth; truncated to integral value
DateInterval.Quarter qq Pilar truncado en valor enteroQuarter; truncated to integral value
DateInterval.Second ss Second redondeado al milisegundo más cercanoSecond; rounded to nearest millisecond
DateInterval.Weekday sw Diariamente truncado en valor enteroDay; truncated to integral value
DateInterval.WeekOfYear wwww Quincenal truncado en valor enteroWeek; truncated to integral value
DateInterval.Year yyyyyyyy Anual truncado en valor enteroYear; truncated to integral value
Consulte también:

Se aplica a