Trả về một Biến_thể (Ngày) chứa một ngày đã thêm khoảng thời gian xác định.
Cú pháp
DateAdd ( interval, number, date )
Cú pháp hàm DateAdd có các đối số sau đây:
|
Đối số |
Mô tả |
|---|---|
|
interval |
Bắt buộc. Biểu thức chuỗi là khoảng thời gian bạn muốn thêm. |
|
number |
Bắt buộc. Biểu thức số là số khoảng thời gian bạn muốn thêm. Có thể dương (để lấy ngày trong tương lai) hoặc âm (để lấy ngày trong quá khứ). |
|
ngày |
Bắt buộc. Biến _thể (Ngày) hoặc chữ thể hiện ngày đã thêm khoảng cách. |
Thiết đặt
Khoảng thời giantham đối có các thiết đặt sau:
|
Thiết đặt |
Mô tả |
|---|---|
|
yyyy |
Năm |
|
q |
Quý |
|
m |
Tháng |
|
y |
Ngày trong năm |
|
d |
Ngày |
|
w |
Weekday |
|
ww |
Tuần |
|
h |
Giờ |
|
n |
Phút |
|
. |
Giây |
Chú thích
Bạn có thể sử dụng hàm DateAdd để cộng hoặc trừ một khoảng thời gian đã xác định từ một ngày. Ví dụ: bạn có thể sử dụng DateAdd để tính toán ngày cách ngày hôm nay 30 ngày hoặc thời gian 45 phút kể từ bây giờ.
Để thêm ngày cho đến nay, bạn có thể sử dụng Ngày trong Năm ("y"), Ngày ("d" ) hoặc Ngày trong tuần ("w").
Hàm DateAdd sẽ không trả về một ngày không hợp lệ. Ví dụ sau đây sẽ thêm một tháng vào ngày 31 tháng 1:
DateAdd("m", 1, "31-Jan-95")
Trong trường hợp này, DateAdd trả về 28-Feb-95, chứ không phải 31-Thg2-95. Nếu ngày là 31-Thg1-96, nó trả về 29-Feb-96 vì 1996 là một năm nhuận.
Nếu ngày tính toán trước năm 100 (nghĩa là bạn trừ nhiều năm hơn so với ngày), sẽ xảy ra lỗi.
Nếu số không phải là giá trị Dài, nó được làm tròn đến số nguyên gần nhất trước khi được đánh giá.
Lưu ý: Định dạng của giá trị trả về cho DateAdd được xác định Panel điều khiển thiết đặt, không phải theo định dạng được thông qua trong đối số date.
Lưu ý: Đối với ngày, nếu cài đặt thuộc tính Lịch là lịch Gregory, ngày được cung cấp phải là lịch Gregory. Nếu lịch là Hijri, ngày tháng được cung cấp phải là Hijri. Nếu giá trị tháng là tên, tên phải nhất quán với cài đặt thuộc tính Lịch hiện tại. Để giảm thiểu khả năng tên tháng xung đột với cài đặt thuộc tính Lịch hiện tại, hãy nhập giá trị tháng dạng số (định dạng Ngày Dạng ngắn).
Ví dụ về truy vấn
|
Biểu thức |
Kết quả |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Trả về kết quả bằng cách cộng 1 năm vào giá trị ngày của trường "DateofSale". |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Trả về kết quả bằng cách trừ 1 năm vào giá trị ngày của trường "DateofSale". |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Trả về kết quả trong cột "NewDate" bằng cách thêm 10 ngày vào giá trị ngày của trường "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Trả về kết quả trong cột "NewDate" bằng cách trừ 1 tuần (7 ngày) ra khỏi giá trị ngày của trường "DateofSale". |
Ví dụ về VBA
Lưu ý: Các ví dụ sau thể hiện cách sử dụng hàm này trong mô-đun Visual Basic for Applications (VBA). Để biết thêm thông tin về cách làm việc với VBA, hãy xem Tham khảo về VBA trong Access.
Ví dụ này lấy ngày làm đầu vào và sử dụng hàm DateAdd để hiển thị một ngày tương ứng với số tháng đã xác định trong tương lai.
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
