Função SomData

Nota: Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

Devolve uma Variante (Data) contendo a data à qual foi adicionado um intervalo de tempo especifico.

Sintaxe

DateAdd ( intervalo, número, data )

A sintaxe da função SomData tem os seguintes argumentos:

Argumento

Descrição

interval

Obrigatório. Expressão de cadeia que corresponde ao intervalo de tempo que pretende adicionar.

número

Obrigatório. Expressão numérica que é o número de intervalos que pretende adicionar. Pode ser positivo (para obter as datas no futuro) ou negativo (para obter as datas no passado).

data

Obrigatório. Variante (Data) ou literal representando uma data à qual o intervalo é adicionado.


Sugestão: No Access 2010, o construtor de expressões tem IntelliSense, para que possa ver que argumentos requer a expressão.

Definições

O argumento intervalargumento tem as seguintes definições:

Definição

Descrição

aaaa

Ano

t

Trimestre

m

Mês

a

Dia do ano

d

Dia

s

Dia útil

ss

Semana

h

Hora

n

Minuto

s

Segundo


Observações

Pode utilizar a função SomData para somar ou subtrair um intervalo de tempo especificado a uma data. Por exemplo, pode utilizar DateAdd para calcular uma data de 30 dias a partir de hoje ou uma hora 45 minutos a partir de agora.

Para adicionar dias à data, pode utilizar dia do ano ("y"), dia ("d") ou o dia da semana ("w").

A função SomData não irá devolver uma data inválida. O exemplo seguinte adiciona um mês a 31 de Janeiro:

DateAdd("m", 1, "31-Jan-95")

Neste caso, DateAdd devolve 28-Fev-95, não 31-Fev-95. Se a data for 31-Jan-96 devolve 29-Fev-96 porque 1996 é um ano bissexto.

Se a data calculada seria precede o ano 100 (ou seja, subtrair anos mais do que estão na data), ocorre um erro.

Se número não for um valor longo, é arredondado para o número inteiro mais próximo antes de a ser avaliada.

Nota: O formato do valor de retorno para DateAdd é determinado pelas definições do Painel de controlo , não pelo formato que lhe é transmitido do argumento date .

Nota: Para a data, se a definição da propriedade calendário for gregoriano, a data fornecida tem de ser gregoriano. Se o calendário Hijri, a data fornecida tem de ser Hijri. Se os valores do mês são nomes, o nome tem de ser compatível com a definição da propriedade calendário atual. Para minimizar a possibilidade de nomes de meses em conflito com a definição da propriedade calendário atual, introduza valores numéricos de mês (formato de data abreviada).

Exemplo

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo leva-o até uma data como entrada e utiliza a função SomData para apresentar uma data correspondente um número especificado de meses no futuro.

Dim FirstDate As Date    ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg
Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×