Belirtilen bir zaman aralığı eklenmiş olan bir tarihi içeren Variant (Tarih) veri türünü döndürür.
Sözdizimi
DateAdd ( aralık, sayı, tarih )
DateAdd işlevinin söz diziminde şu bağımsız değişkenler bulunur:
|
Bağımsız değişken |
Açıklama |
|---|---|
|
aralık |
Gerekli. Eklemek istediğiniz zaman aralığı olan dize ifadesi. |
|
sayı |
Gerekli. Eklemek istediğiniz aralık sayısı olan sayısal ifade. Bu sıfırdan büyük (gelecekteki tarihleri getirmek için) veya sıfırdan küçük (geçmişteki tarihleri getirmek için) olabilir. |
|
tarih |
Gerekli. Aralığın eklendiği tarihi temsil eden değişken (Tarih) veya değişmez değer. |
Ayarlar
aralıkbağımsız değişken şu ayarlara sahiptir:
|
Ayar |
Açıklama |
|---|---|
|
yyyy |
Yıl |
|
ç |
Çeyrek |
|
a |
Ay |
|
y |
Yılın günü |
|
d |
Gün |
|
h |
Weekday |
|
hh |
Hafta |
|
s |
Saat |
|
d |
Dakika |
|
sn |
Saniye |
Açıklamalar
Belirtilen zaman aralığını bir tarihe eklemek veya çıkarmak için DateAdd işlevini kullanabilirsiniz. Örneğin, bugünden itibaren 30 gün veya bundan 45 dakika sonra bir tarih hesaplamak için DateAdd işlevini kullanabilirsiniz.
Bugüne gün eklemek için Yılın Günü ("y"), Gün ("d") veya Hafta İçi ("w") kullanabilirsiniz.
DateAdd işlevi 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 , DateAdd 31-Şub-95 değil, 28-Şub-95 döndürür. Tarih 31 Ocak 96 ise, 1996 artık yıl olduğundan 29 Şubat-96 döndürür.
Hesaplanan tarih 100 yıldan önceyse (yani, tarihe göre daha fazla yıl çıkarırsanız) bir hata oluşur.
Sayı Bir Uzun değeri değilse, değerlendirilmeden önce en yakın tam sayıya yuvarlanmış olur.
Not: DateAdd için dönüş değerinin biçimi, tarih bağımsız değişkeninde geçirilen biçime göre değil Denetim Masası ayarlarına göre belirlenir.
Not: Tarih için, Takvim özellik ayarı Gregoryen ise, sağlanan tarih Gregoryen olmalıdır. Takvim Hicri ise, sağlanan tarih Hicri olmalıdır. Ay değerleri adsa, adın geçerli Takvim özellik ayarıyla tutarlı olması gerekir. Ay adlarının geçerli Takvim özellik ayarıyla çakışma olasılığını en aza indirmek için sayısal ay değerleri (Kısa Tarih biçimi) girin.
Sorgu örnekleri
|
Expression |
Sonuçlar |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
"DateofSale" alanının tarih değerlerine 1 yıl ekleyerek sonuçları döndürür. |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
"DateofSale" alanının tarih değerlerine 1 yıl çıkararak sonuçları döndürür. |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" alanının tarih değerlerine 10 gün ekleyerek "YeniTarih" sütunundaki sonuçları döndürür. |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" alanının tarih değerlerinden 1 hafta (7 gün) çıkararak "YeniTarih" sütunundaki sonuçları döndürür. |
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. VBA başvurusuna erişme.
Bu örnek giriş olarak bir tarih alır ve gelecekte belirtilen sayıda ay için karşılık gelen tarihi görüntülemek için DateAdd işlevini kullanır.
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
