DateAndTime.DateAdd Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimePará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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Resumen de tipos de datos (Visual Basic)
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 -> DateTimePublic Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTimePará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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Resumen de tipos de datos (Visual Basic)
