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 Date valor que contiene un valor de fecha y hora al que se ha agregado un intervalo de tiempo especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| DateAdd(DateInterval, Double, DateTime) |
Devuelve un valor que contiene un valor de fecha y hora al que se ha agregado un intervalo de tiempo especificado. |
| DateAdd(String, Double, Object) |
Devuelve un valor que contiene un valor de fecha y hora al que se ha agregado un intervalo de tiempo especificado. |
DateAdd(DateInterval, Double, DateTime)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
Devuelve un valor que contiene un valor de fecha y hora al que se ha agregado 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 DateInterval de enumeración o expresión de cadena que representa el intervalo de tiempo que desea agregar.
- Number
- Double
Obligatorio. Expresión de punto flotante que representa el número de intervalos que desea agregar. Puede ser positivo (para obtener valores de fecha y hora en el futuro) o negativo (para obtener valores de fecha y hora en el pasado). Puede contener una parte fraccionarcional cuando Interval especifica horas, minutos o segundos. Para otros valores de Interval, se omite cualquier parte fraccionaria de Number .
- DateValue
- DateTime
Obligatorio. Expresión que representa la fecha y hora a la que se va a agregar el intervalo.
DateValue el propio no se cambia en el programa de llamada.
Devoluciones
Valor que contiene un valor de fecha y hora al que se ha agregado un intervalo de tiempo especificado.
Excepciones
DateValue no es coercible a Date.
Interval no es válido.
La fecha calculada es anterior a las 00:00:00 el 1 de enero del año 1 o posterior a las 23:59:59 el 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. El ejemplo siguiente 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 del calendario actual de la CurrentCulture propiedad de la CultureInfo clase en el System.Globalization espacio de nombres . Los valores predeterminados CurrentCulture se determinan mediante la configuración del Panel de control .
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 fraccionario 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 |
y | Día; truncado al valor entero |
DateInterval.Hour |
h | Hora; redondeado a milisegundos más cercano |
DateInterval.Minute |
n | Minuto; redondeado a milisegundos más cercano |
DateInterval.Month |
m | Mes; truncado al valor entero |
DateInterval.Quarter |
q | Trimestre; truncado al valor entero |
DateInterval.Second |
s | Segundo; redondeado a milisegundos 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
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
Devuelve un valor que contiene un valor de fecha y hora al que se ha agregado 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 DateInterval de enumeración o expresión de cadena que representa el intervalo de tiempo que desea agregar.
- Number
- Double
Obligatorio. Expresión de punto flotante que representa el número de intervalos que desea agregar.
Number puede ser positivo (para obtener valores de fecha y hora en el futuro) o negativo (para obtener valores de fecha y hora en el pasado). Puede contener una parte fraccionarcional cuando Interval especifica horas, minutos o segundos. Para otros valores de Interval, se omite cualquier parte fraccionaria de Number .
- DateValue
- Object
Obligatorio. Expresión que representa la fecha y hora a la que se va a agregar el intervalo.
DateValue el propio no se cambia en el programa de llamada.
Devoluciones
Valor que contiene un valor de fecha y hora al que se ha agregado un intervalo de tiempo especificado.
Excepciones
DateValue no es coercible a Date.
Interval no es válido.
La fecha calculada es anterior a las 00:00:00 el 1 de enero del año 1 o posterior a las 23:59:59 el 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. El ejemplo siguiente 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 del calendario actual de la CurrentCulture propiedad de la CultureInfo clase en el System.Globalization espacio de nombres . Los valores predeterminados CurrentCulture se determinan mediante la configuración del Panel de control .
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 fraccionario 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 |
y | Día; truncado al valor entero |
DateInterval.Hour |
h | Hora; redondeado a milisegundos más cercano |
DateInterval.Minute |
n | Minuto; redondeado a milisegundos más cercano |
DateInterval.Month |
m | Mes; truncado al valor entero |
DateInterval.Quarter |
q | Trimestre; truncado al valor entero |
DateInterval.Second |
s | Segundo; redondeado a milisegundos 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)
