DateAndTime.DateAdd Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Retorna um Date valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.

Sobrecargas

Nome	Description
DateAdd(DateInterval, Double, DateTime)	Retorna um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.
DateAdd(String, Double, Object)	Retorna um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.

DateAdd(DateInterval, Double, DateTime)

Origem:

DateAndTime.vb

Retorna um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.

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

Obrigatório Um DateInterval valor de enumeração ou uma expressão de cadeia de caracteres que representa o intervalo de tempo que você deseja adicionar.

Number

Double

Obrigatório Expressão de ponto flutuante que representa o número de intervalos que você deseja adicionar. Pode ser positivo (para obter valores de data/hora no futuro) ou negativo (para obter valores de data/hora no passado). Ele pode conter uma parte fracionária quando Interval especifica horas, minutos ou segundos. Para outros valores de Interval, qualquer parte Number fracionária é ignorada.

DateValue

DateTime

Obrigatório Uma expressão que representa a data e a hora em que o intervalo deve ser adicionado. DateValue em si não é alterado no programa de chamada.

Retornos

DateTime

Um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.

Exceções

InvalidCastException

DateValue não é coercível a Date.

ArgumentException

Interval não é válido.

ArgumentOutOfRangeException

A data calculada é antes das 00:00:00 em 1º de janeiro do ano 1, ou posterior às 23:59:59 em 31 de dezembro de 9999.

Exemplos

Este exemplo usa uma data e, usando a DateAdd função, exibe 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)

Comentários

Você pode usar a DateAdd função para adicionar ou subtrair um intervalo de tempo especificado de uma data. Por exemplo, você pode calcular uma data de 30 dias a partir de hoje ou uma hora de 45 minutos antes de agora.

Para adicionar dias a DateValue, você pode usar DateInterval.Day, DateInterval.DayOfYearou DateInterval.Weekday. Eles são tratados como equivalentes porque DayOfYearWeekday não são intervalos de tempo significativos.

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

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

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

Observação

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

Como cada Date valor tem suporte por uma DateTime estrutura, seus métodos oferecem opções adicionais na adição de intervalos de tempo. Por exemplo, você pode adicionar um número fracionário de dias, arredondado para o milissegundo mais próximo, a uma Date variável da seguinte maneira:

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 uma das seguintes configurações.

Valor de enumeração	String	Unidade de intervalo de tempo a ser adicionada
DateInterval.Day	d	Dia; truncado para o valor integral
DateInterval.DayOfYear	y	Dia; truncado para o 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 para o valor integral
DateInterval.Quarter	q	Quarto; truncado para o valor integral
DateInterval.Second	s	Segundo; arredondado para o milissegundo mais próximo
DateInterval.Weekday	w	Dia; truncado para o valor integral
DateInterval.WeekOfYear	Ww	Semana; truncado para o valor integral
DateInterval.Year	yyyy	Ano; truncado para o valor integral

Confira também

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Resumo do tipo de dados (Visual Basic)

DateAdd(String, Double, Object)

Origem:

DateAndTime.vb

Retorna um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.

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

Obrigatório Um DateInterval valor de enumeração ou uma expressão de cadeia de caracteres que representa o intervalo de tempo que você deseja adicionar.

Number

Double

Obrigatório Expressão de ponto flutuante que representa o número de intervalos que você deseja adicionar. Number pode ser positivo (para obter valores de data/hora no futuro) ou negativo (para obter valores de data/hora no passado). Ele pode conter uma parte fracionária quando Interval especifica horas, minutos ou segundos. Para outros valores de Interval, qualquer parte Number fracionária é ignorada.

DateValue

Object

Obrigatório Uma expressão que representa a data e a hora em que o intervalo deve ser adicionado. DateValue em si não é alterado no programa de chamada.

Retornos

DateTime

Um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.

Exceções

InvalidCastException

DateValue não é coercível a Date.

ArgumentException

Interval não é válido.

ArgumentOutOfRangeException

A data calculada é antes das 00:00:00 em 1º de janeiro do ano 1, ou posterior às 23:59:59 em 31 de dezembro de 9999.

Exemplos

Este exemplo usa uma data e, usando a DateAdd função, exibe 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)

Comentários

Você pode usar a DateAdd função para adicionar ou subtrair um intervalo de tempo especificado de uma data. Por exemplo, você pode calcular uma data de 30 dias a partir de hoje ou uma hora de 45 minutos antes de agora.

Para adicionar dias a DateValue, você pode usar DateInterval.Day, DateInterval.DayOfYearou DateInterval.Weekday. Eles são tratados como equivalentes porque DayOfYearWeekday não são intervalos de tempo significativos.

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

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

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

Observação

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

Como cada Date valor tem suporte por uma DateTime estrutura, seus métodos oferecem opções adicionais na adição de intervalos de tempo. Por exemplo, você pode adicionar um número fracionário de dias, arredondado para o milissegundo mais próximo, a uma Date variável da seguinte maneira:

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 uma das seguintes configurações.

Valor de enumeração	String	Unidade de intervalo de tempo a ser adicionada
DateInterval.Day	d	Dia; truncado para o valor integral
DateInterval.DayOfYear	y	Dia; truncado para o 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 para o valor integral
DateInterval.Quarter	q	Quarto; truncado para o valor integral
DateInterval.Second	s	Segundo; arredondado para o milissegundo mais próximo
DateInterval.Weekday	w	Dia; truncado para o valor integral
DateInterval.WeekOfYear	Ww	Semana; truncado para o valor integral
DateInterval.Year	yyyy	Ano; truncado para o valor integral

Confira também

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Resumo do tipo de dados (Visual Basic)