DateAndTime.DateAdd Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um valor Date que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.
Sobrecargas
| 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
- Origem:
- DateAndTime.vb
- 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 -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimeParâmetros
- Interval
- DateInterval
Obrigatórios. Um valor de enumeração DateInterval ou uma expressão de cadeia de caracteres que representa o intervalo de tempo que você deseja adicionar.
- Number
- Double
Obrigatórios. 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). Pode conter uma fração quando Interval especifica horas, minutos ou segundos. Para outros valores de Interval, qualquer fração de Number será ignorada.
- DateValue
- DateTime
Obrigatórios. Uma expressão que representa a data e hora para a qual o intervalo deve ser adicionado. DateValue em si não é alterado no programa de chamada.
Retornos
Um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.
Exceções
DateValue não é coercível para Date.
Interval não é válido.
A data calculada é anterior à 00:00:00 do dia 1º de janeiro do ano 1 ou posterior às 23:59:59 do dia 31 de dezembro de 9999.
Exemplos
Este exemplo usa uma data e, usando a DateAdd função , exibe uma data correspondente com 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 DayOfYear e Weekday 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#, retornará #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 por Painel de Controle configurações.
Como cada Date valor tem suporte de uma DateTime estrutura, seus métodos oferecem opções adicionais para adicionar 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 configurações a seguir.
| Valor de enumeração | String | Unidade de intervalo de tempo a ser adicionada |
|---|---|---|
DateInterval.Day |
d | Dia; truncado para o valor integral |
DateInterval.DayOfYear |
s | 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)
Aplica-se a
DateAdd(String, Double, Object)
- Origem:
- DateAndTime.vb
- Origem:
- DateAndTime.vb
- 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);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
Obrigatórios. Um valor de enumeração DateInterval ou uma expressão de cadeia de caracteres que representa o intervalo de tempo que você deseja adicionar.
- Number
- Double
Obrigatórios. 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). Pode conter uma fração quando Interval especifica horas, minutos ou segundos. Para outros valores de Interval, qualquer fração de Number será ignorada.
- DateValue
- Object
Obrigatórios. Uma expressão que representa a data e hora para a qual o intervalo deve ser adicionado. DateValue em si não é alterado no programa de chamada.
Retornos
Um valor que contém um valor de data e hora ao qual um intervalo de tempo especificado foi adicionado.
Exceções
DateValue não é coercível para Date.
Interval não é válido.
A data calculada é anterior à 00:00:00 do dia 1º de janeiro do ano 1 ou posterior às 23:59:59 do dia 31 de dezembro de 9999.
Exemplos
Este exemplo usa uma data e, usando a DateAdd função , exibe uma data correspondente com 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 DayOfYear e Weekday 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#, retornará #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 por Painel de Controle configurações.
Como cada Date valor tem suporte de uma DateTime estrutura, seus métodos oferecem opções adicionais para adicionar 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 configurações a seguir.
| Valor de enumeração | String | Unidade de intervalo de tempo a ser adicionada |
|---|---|---|
DateInterval.Day |
d | Dia; truncado para o valor integral |
DateInterval.DayOfYear |
s | 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)
