Função SomData

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 DateAdd 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 representa o número de intervalos que pretende adicionar. Pode ser positivo (para obter datas no futuro) ou negativo (para obter datas no passado)

data

Obrigatório. Variante (Data) ou literal que representa a data à qual o intervalo é adicionado.

Sugestão:  No Access 2010, o Construtor de Expressões tem IntelliSense, para que possa ver que argumentos a sua expressão necessita. 

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 DateAdd para somar ou subtrair um intervalo de tempo especificado a partir de uma data. Por exemplo, pode utilizar a função DateAdd para calcular uma data 30 dias a partir de hoje ou uma hora de 45 minutos a partir de agora.

Para somar dias à Data, pode utilizar dia do ano ("y"), dia ("d") ou dia útil ("w").

A função DateAdd 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, a DateAdd devolve 28-fev-95, e não 31-fev-95. Se Data for 31-Jan-96, devolve 29-fev-96 porque 1996 é um ano bissexto.

Se a data calculada preceder o ano 100 (ou seja, se subtrair mais anos do que a Data), ocorre um erro.

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

Nota:  O formato do valor de retorno para DateAdd é determinado pelas definições do painel de controlo e não pelo formato que é passado no argumento Data .

Nota:  Para date, se a definição da propriedade do Calendário for Gregoriano, a data fornecida tem de ser Gregoriana. Se o calendário for Hijri, a data fornecida tem de ser Hijri. Se os valores de mês forem nomes, o nome tem de ser consistente com a definição de Propriedade do calendário atual. Para minimizar a possibilidade de nomes de meses em conflito com a definição de Propriedade do calendário atual, introduza os valores dos meses numéricos (formato de data abreviada).

Exemplos de consulta

Expressão

Resultados

Selecione SomData ("aaaa", 1, [DateofSale]) como expr1 do ProductSales;

Devolve os resultados adicionando 1 ano aos valores de data do campo "DateofSale".

Selecione SomData ("aaaa",-1, [DateofSale]) como expr1 do ProductSales;

Devolve os resultados ao subtrair 1 ano pelos valores de data do campo "DateofSale".

Selecione SomData ("d", 10, [DateofSale]) como NewDate a partir de ProductSales;

Devolve os resultados na coluna "NewDate" ao somar 10 dias aos valores de data do campo "DateofSale".

Selecione SomData ("WW",-1, [DateofSale]) como NewDate a partir de ProductSales;

Devolve os resultados na coluna "NewDate" ao subtrair 1 semana (7 dias) a partir dos valores de data do campo "DateofSale".

Exemplo de VBA

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 como 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 uma data como entrada e utiliza a função SomData para apresentar uma data correspondente com 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

Nota:  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 indicar-nos se estas informações foram úteis? Eis o artigo em inglês para sua referência.​

Consulte Também

Escolher a função de data correta

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.

×