Belirtilen bir zaman aralığı eklenmiş bir tarih içeren bir Variant (Tarih) döndürür.
Söz dizimi
DateAdd(interval, number, date)
İşlevin DateAdd aşağıdaki bağımsız değişkenleri vardır:
| Bağımsız değişken | Açıklama |
|---|---|
interval |
Gerekli. Dize ifadesi, eklemek istediğiniz zaman aralığıdır. |
number |
Gerekli. Eklemek istediğiniz aralıkların sayısı olan sayısal ifadeler. Gelecekteki tarihleri almak pozitif, geçmişteki tarihleri almak negatif olabilir. |
date |
Gerekli. Aralığın eklendiği tarihi temsil eden değişken (Tarih) veya değişmez değer. |
Ayarlar
Bağımsız interval değişken aşağıdaki ayarlara sahiptir:
| Ayar | Açıklama |
|---|---|
yyyy |
Yıl |
q |
Çeyrek |
m |
Ay |
y |
Yılın günü |
d |
Gün |
w |
Weekday |
ww |
Hafta |
h |
Saat |
n |
Dakika |
s |
Saniye |
Açıklamalar
Bir tarihe belirli bir zaman aralığı eklemek veya tarihten belirli bir zaman aralığı çıkarmak için işlevi kullanabilirsiniz DateAdd . Örneğin, bugünden 30 gün sonraki bir tarihi veya 45 dakika sonraki bir zamanı hesaplamak için kullanabilirsiniz DateAdd .
'ye gün eklemek için dateYılın Günü ("y"), Gün ("d") veya Hafta İçi ("w") kullanabilirsiniz.
İşlev DateAdd geçersiz bir tarih döndürmez. Aşağıdaki örnek, 31 Ocak'a bir ay ekler:
DateAdd("m", 1, "31-Jan-95")
Bu durumda, 31-Şub-95 değil, DateAdd 28-Şub-95 sonucunu verir. 31-Oca-96 ise date , 1996 artık yıl olduğu için 29-Şub-96 sonucunu verir.
Hesaplanan tarih 100 yılından önceyse, bu da içinde datebulunandan daha fazla yıl çıkardığınız anlamına gelirse, bir hata oluşur.
Uzun değer değilse number , Access ifadeyi değerlendirmeden önce değeri en yakın tamsayıya yuvarlar.
Not
Döndürülen DateAdd değerin biçimi, bağımsız değişkende aktarılan biçime göre değil, Denetim Masası ayarlara date göre belirlenir.
Not
için date, özellik ayarı Gregoryen ise Calendar , sağlanan tarih Gregoryen olmalıdır. Takvim Hicri ise, belirtilen tarih Hicri olmalıdır. Ay değerleri adsa, adın geçerli Calendar özellik ayarıyla eşleşmesi gerekir. Çakışma olasılığını azaltmak için, sayısal ay değerlerini Kısa Tarih biçiminde girin.
Sorgu örnekleri
| İfade | Sonuçlar |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Alandaki tarih değerlerine DateofSale 1 yıl ekler. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Alandaki tarih değerlerinden DateofSale 1 yıl çıkarır. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Alandaki tarih değerlerine DateofSale 10 gün ekler ve sonuçları sütunda NewDate döndürür. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Alandaki tarih değerlerinden DateofSale 1 hafta veya 7 gün çıkarır ve sonuçları sütunda NewDate verir. |
VBA örneği
Not
Aşağıdaki örneklerde, bu işlevin Visual Basic for Applications (VBA) modülünde kullanımı gösterilir. VBA ile çalışma hakkında daha fazla bilgi için bkz. Access VBA başvurusu.
Bu örnek, girdi olarak bir tarihi alır ve işlevi kullanarak DateAdd gelecek belirli sayıda ay için eşleşen tarihi görüntüler.
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