DateAndTime.DateAdd Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve um Date valor contendo um valor de data e hora ao qual foi adicionado um intervalo de tempo especificado.

Sobrecargas

Name	Description
DateAdd(DateInterval, Double, DateTime)	Devolve um valor contendo um valor de data e hora ao qual foi adicionado um intervalo de tempo especificado.
DateAdd(String, Double, Object)	Devolve um valor contendo um valor de data e hora ao qual foi adicionado um intervalo de tempo especificado.

DateAdd(DateInterval, Double, DateTime)

Devolve um valor contendo um valor de data e hora ao qual foi adicionado um intervalo de tempo 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

Required. Um valor de enumeração ou uma expressão string que DateInterval represente o intervalo de tempo que pretende adicionar.

Number: Double

Required. Expressão em ponto flutuante que representa o número de intervalos que pretende adicionar. Pode ser positivo (para obter valores de data/hora no futuro) ou negativo (para obter valores de data/hora no passado). Pode conter uma parte fracionada quando Interval especificar horas, minutos ou segundos. Para outros valores de Interval, qualquer parte fracionária de Number é ignorada.

DateValue: DateTime

Required. Uma expressão que representa a data e hora à qual o intervalo deve ser adicionado. DateValue ele próprio não é alterado no programa de chamada.

Devoluções

DateTime

Um valor contendo um valor de data e hora ao qual foi adicionado um intervalo de tempo especificado.

Exceções

InvalidCastException

DateValue não é coercivo a Date.

ArgumentException

Interval não é válido.

ArgumentOutOfRangeException

A data calculada é antes das 00:00:00 de 1 de janeiro do ano 1, ou depois das 23:59:59 de 31 de dezembro de 9999.

Exemplos

Este exemplo toma uma data e, usando a DateAdd função, mostra uma data correspondente um número especificado de meses no 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)

Observações

Pode usar a DateAdd função para adicionar ou subtrair um intervalo de tempo especificado de uma data. Por exemplo, pode calcular uma data daqui a 30 dias ou uma data 45 minutos antes.

Para adicionar dias a DateValue, pode usar DateInterval.Day, DateInterval.DayOfYear, ou DateInterval.Weekday. Estes são tratados como equivalentes porque DayOfYear e Weekday não são intervalos de tempo significativos.

A DateAdd função nunca devolve uma data inválida. Se necessário, a parte do dia da data resultante é ajustada para baixo até ao último dia do mês resultante no ano resultante. O exemplo seguinte adiciona um mês a 31 de janeiro:

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

Neste exemplo, DateAdd devolve #2/28/1995#, não #2/31/1995#. Se DateValue for #1/31/1996#, retorna #2/29/1996# porque 1996 é um ano bissexto.

Note

DateAdd usa a definição atual do calendário da CurrentCulture propriedade da CultureInfo classe no System.Globalization namespace. Os valores predefinidos de CurrentCulture são determinados pelas definições Painel de Controlo.

Como cada Date valor é suportado por uma DateTime estrutura, os seus métodos dão-lhe opções adicionais para adicionar intervalos de tempo. Por exemplo, pode adicionar um número fracionado de dias, arredondado para o milissegundo mais próximo, a uma Date variável da seguinte forma:

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

O Interval argumento pode ter um dos seguintes contextos.

Valor de enumeração	String	Unidade de intervalo de tempo para adicionar
`DateInterval.Day`	d	Day; truncado ao valor integral
`DateInterval.DayOfYear`	y	Day; truncado ao valor integral
`DateInterval.Hour`	h	Hora; arredondado para o milissegundo mais próximo
`DateInterval.Minute`	n	Minuto; arredondado para o milissegundo mais próximo
`DateInterval.Month`	m	Mês; truncado ao valor integral
`DateInterval.Quarter`	q	Quarter; truncado ao valor integral
`DateInterval.Second`	s	Segundo; arredondado para o milissegundo mais próximo
`DateInterval.Weekday`	w	Day; truncado ao valor integral
`DateInterval.WeekOfYear`	ss	Semana; truncado ao valor integral
`DateInterval.Year`	yyyy	Ano; truncado ao valor integral

Ver também

Aplica-se a

DateAdd(String, Double, Object)