Returnerar ett värde av datatypen Variant (Datum) som innehåller ett datum som ett visst tidsintervall lagts till för.
Syntax
DatumLägg till(intervall; tal; datum)
Syntaxen för funktionen DatumLägg Till har följande argument:
| argument | Beskrivning |
|---|---|
| intervall | Obligatoriskt. Stränguttryck som är det tidsintervall du vill lägga till. |
| tal | Obligatoriskt. Numeriskt uttryck som är det antal intervall du vill lägga till. Argumentet kan vara positivt (för att hämta framtida datum) eller negativt (för att hämta passerade datum). |
| Datum | Obligatoriskt. Variant (Datum) eller literal som representerar datum som intervallet läggs till i. |
Inställningar
Intervallargumentethar följande inställningar:
| Inställning | Beskrivning |
|---|---|
| yyyy | År |
| q | Kvartal |
| m | Månad |
| y | Dag på året |
| d | Dag |
| w | Veckodag |
| ww | Vecka |
| h | Timme |
| n | Minut |
| s | Sekund |
Kommentarer
Du kan använda funktionen DatumLägg till för att adderas eller subtrahera ett angivet tidsintervall från ett datum. Du kan till exempel använda DateAdd för att beräkna ett datum 30 dagar från i dag eller en tid om 45 minuter.
Om du vill lägga till dagar till datum kan du använda Day of Year ("y"), Day ("d" eller Weekday ("w").
Funktionen DatumLägg Till returnerar inte ett ogiltigt datum. I följande exempel läggs en månad till den 31 januari:
DateAdd("m", 1, "31-Jan-95")
I det här fallet returnerar DateAdd 28-feb-95, inte 31-feb-95. Om datumet är 31 jan-96 returneras 29 februari 1996 eftersom 1996 är ett skottår.
Om det beräknade datumet föregår år 100 (d.v.s. du subtraherar fler år än i datum) uppstår ett fel.
Om tal inte är ett Long-värde avrundas det till närmaste heltal innan det utvärderas.
Obs
Formatet på returvärdet för DateAdd bestäms av Kontrollpanelen inställningar, inte av formatet som skickas i argumentet datum.
Obs
För datum måste det angivna datumet vara gregorianskt om inställningen för den Calendar egenskapen är gregoriansk. Om kalendern är Hijri måste det datum som anges vara Hijri. Om månadsvärden är namn måste namnet vara konsekvent med den aktuella Calendar egenskapsinställningen. Om du vill minimera risken för månadsnamn som är i konflikt med den aktuella Calendar egenskapsinställningen anger du numeriska månadsvärden (kort datumformat).
Frågeexempel
| Uttryck | Resultat |
|---|---|
| SELECT DateAdd("YYYY",1,[DateofSale]) AS Uttr1 FROM ProductSales; | Returnerar resultatet genom att lägga till 1 år till datumvärdena för fältet "DateofSale". |
| SELECT DateAdd("YYYY",-1,[DateofSale]) AS Uttr1 FROM ProductSales; | Returnerar resultatet genom att subtrahera 1 år till datumvärdena för fältet "DateofSale". |
| SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Returnerar resultatet i kolumnen "NewDate" genom att lägga till 10 dagar till datumvärdena för fältet "DateofSale". |
| SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; | Returnerar resultatet i kolumnen "NewDate" genom att subtrahera 1 vecka (7 dagar) från datumvärdena i fältet "DateofSale". |
VBA-exempel
Obs
I exemplen nedan visar vi hur du använder den här funktionen i en Visual Basic for Applications-modul (VBA). Mer information om hur du arbetar med VBA finns i Access VBA-referens.
Det här exemplet tar ett datum som indata och använder funktionen DatumLägg Till för att visa ett motsvarande datum ett angivet antal månader i framtiden.
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