Compartir vía


DateAndTime.DateAdd Método

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.

Sobrecargas

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.

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.

DateAdd(DateInterval, Double, DateTime)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

Devuelve un valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.

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

Obligatorio. Valor de enumeración DateInterval o expresión de cadena que representa el intervalo de tiempo que se desea sumar.

Number
Double

Obligatorio. Expresión de punto flotante que representa el número de intervalos que se desea sumar. Puede ser positivo (para obtener valores de fecha y hora futuros) o negativo (para obtener valores de fecha y hora del pasado). Puede contener una parte fraccionaria cuando Interval especifica horas, minutos o segundos. Para otros valores de Interval, se omite cualquier parte fraccionaria de Number.

DateValue
DateTime

Obligatorio. Una expresión que representa la fecha y la hora a las que se va a sumar el intervalo. DateValue no se cambia en el programa que realiza la llamada.

Devoluciones

Valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.

Excepciones

DateValue no está establecido en Date.

Interval no es válido.

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.

Ejemplos

En este ejemplo se toma una fecha y, con la DateAdd función , se muestra una fecha correspondiente un número especificado de meses en el futuro.

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 usar la DateAdd función para agregar o restar un intervalo de tiempo especificado de una fecha. Por ejemplo, puede calcular una fecha de 30 días a partir de hoy o una hora de 45 minutos antes de ahora.

Para agregar días a DateValue, puede usar DateInterval.Day, DateInterval.DayOfYearo DateInterval.Weekday. Se tratan como equivalentes porque DayOfYear y Weekday no son intervalos de tiempo significativos.

La DateAdd función nunca devuelve una fecha no válida. 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. En el ejemplo siguiente se agrega un mes al 31 de enero:

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

En este ejemplo, DateAdd devuelve #2/28/1995#, no #2/31/1995#. Si DateValue es #1/31/1996#, devuelve #2/29/1996# porque 1996 es un año bisiesto.

Nota

DateAdd usa la configuración de calendario actual de la CurrentCulture propiedad de la CultureInfo clase en el System.Globalization espacio de nombres . Los valores predeterminados CurrentCulture se determinan mediante Panel de control configuración.

Dado que cada Date valor es compatible con una DateTime estructura, sus métodos proporcionan opciones adicionales para agregar intervalos de tiempo. Por ejemplo, puede agregar un número fraccionaria de días, redondeado al milisegundo más cercano, a una Date variable como se indica a continuación:

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 de configuración.

Valor de enumeración String Unidad de intervalo de tiempo que se va a agregar
DateInterval.Day d Día; truncado al valor entero
DateInterval.DayOfYear s Día; truncado al valor entero
DateInterval.Hour h Hora; redondeado al milisegundo más cercano
DateInterval.Minute n Minuto; redondeado al milisegundo más cercano
DateInterval.Month m Mes; truncado al valor entero
DateInterval.Quarter q Cuarto; truncado al valor entero
DateInterval.Second s Segundo; redondeado al milisegundo más cercano
DateInterval.Weekday w Día; truncado al valor entero
DateInterval.WeekOfYear ww Semana; truncado al valor entero
DateInterval.Year aaaa Año; truncado al valor entero

Consulte también

Se aplica a

DateAdd(String, Double, Object)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

Devuelve un valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.

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

Parámetros

Interval
String

Obligatorio. Valor de enumeración DateInterval o expresión de cadena que representa el intervalo de tiempo que se desea sumar.

Number
Double

Obligatorio. Expresión de punto flotante que representa el número de intervalos que se desea sumar. Number puede ser positivo (para obtener valores de fecha y hora futuros) o negativo (para obtener valores de fecha y hora del pasado). Puede contener una parte fraccionaria cuando Interval especifica horas, minutos o segundos. Para otros valores de Interval, se omite cualquier parte fraccionaria de Number.

DateValue
Object

Obligatorio. Una expresión que representa la fecha y la hora a las que se va a sumar el intervalo. DateValue no se cambia en el programa que realiza la llamada.

Devoluciones

Valor que contiene un valor de fecha y hora al que se ha sumado un intervalo de tiempo especificado.

Excepciones

DateValue no está establecido en Date.

Interval no es válido.

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.

Ejemplos

En este ejemplo se toma una fecha y, con la DateAdd función , se muestra una fecha correspondiente un número especificado de meses en el futuro.

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 usar la DateAdd función para agregar o restar un intervalo de tiempo especificado de una fecha. Por ejemplo, puede calcular una fecha de 30 días a partir de hoy o una hora de 45 minutos antes de ahora.

Para agregar días a DateValue, puede usar DateInterval.Day, DateInterval.DayOfYearo DateInterval.Weekday. Se tratan como equivalentes porque DayOfYear y Weekday no son intervalos de tiempo significativos.

La DateAdd función nunca devuelve una fecha no válida. 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. En el ejemplo siguiente se agrega un mes al 31 de enero:

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

En este ejemplo, DateAdd devuelve #2/28/1995#, no #2/31/1995#. Si DateValue es #1/31/1996#, devuelve #2/29/1996# porque 1996 es un año bisiesto.

Nota

DateAdd usa la configuración de calendario actual de la CurrentCulture propiedad de la CultureInfo clase en el System.Globalization espacio de nombres . Los valores predeterminados CurrentCulture se determinan mediante Panel de control configuración.

Dado que cada Date valor es compatible con una DateTime estructura, sus métodos proporcionan opciones adicionales para agregar intervalos de tiempo. Por ejemplo, puede agregar un número fraccionaria de días, redondeado al milisegundo más cercano, a una Date variable como se indica a continuación:

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 de configuración.

Valor de enumeración String Unidad de intervalo de tiempo que se va a agregar
DateInterval.Day d Día; truncado al valor entero
DateInterval.DayOfYear s Día; truncado al valor entero
DateInterval.Hour h Hora; redondeado al milisegundo más cercano
DateInterval.Minute n Minuto; redondeado a milisegundos más cercano
DateInterval.Month m Mes; truncado en un valor entero
DateInterval.Quarter q Cuarto; truncado en un valor entero
DateInterval.Second s Segundo; redondeado a milisegundos más cercano
DateInterval.Weekday w Día; truncado en un valor entero
DateInterval.WeekOfYear ww Semana; truncado en un valor entero
DateInterval.Year aaaa Año; truncado en un valor entero

Consulte también

Se aplica a