Trả về một giá trị kiểu Biến_thể (Ngày) cho một năm, tháng, ngày cụ thể.
Cú pháp
DateSerial ( year, month, day )
Cảnh báo Hãy đảm bảo các đối số nằm trong phạm vi giá trị chính xác. Đối số không hợp lệ có thể dẫn đến kết quả không chính xác.
Cú pháp hàm DateSerial có các đối số sau đây:
Đối số |
Mô tả |
năm |
Bắt buộc. Số nguyên. Số từ 100 đến 9999, bao gồm cả 100 và 9999 hoặc số biểu thức số. |
tháng |
Bắt buộc. Số nguyên. Bất kỳ biểu thức số nào. |
ngày |
Bắt buộc. Số nguyên. Bất kỳ biểu thức số nào. |
Chú thích
Để xác định một ngày, chẳng hạn như ngày 31 tháng 12 năm 1991, phạm vi số cho mỗi dateSerialtham đối phải nằm trong phạm vi được chấp nhận cho đơn vị; nghĩa là, 1–31 cho ngày và 1–12 trong nhiều tháng. Tuy nhiên, bạn cũng có thể chỉ định ngày tương đối cho mỗi đối số bằng cách dùng bất kỳ biểu thức số nào đại diện cho một số ngày, tháng hoặc năm trước hoặc sau một ngày nhất định.
Ví dụ sau đây sử dụng biểu thức số thay vì số ngày tuyệt đối. Ở đây, hàm DateSerial trả về một ngày trước ngày đầu tiên (1 - 1), hai tháng trước Tháng Tám (8 - 2), 10 năm trước năm 1990 (1990 - 10); nói cách khác, ngày 31 tháng 5 năm 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Năm có hai chữ số cho đối số year được diễn giải dựa trên thiết đặt máy do người dùng xác định. Cài đặt mặc định là các giá trị từ 0 đến 29, bao gồm cả 0 và 29, được hiểu là năm 2000–2029. Các giá trị mặc định từ 30 đến 99 được hiểu là các năm 1930–1999. Đối với tất cả các đối số năm khác, hãy dùng năm có bốn chữ số (ví dụ: 1800).
Các phiên bản Windows cũ hơn Windows 2000 diễn giải năm có hai chữ số dựa trên các mặc định được mô tả ở trên. Để đảm bảo hàm trả về giá trị thích hợp, hãy dùng năm có bốn chữ số.
Khi bất kỳ đối số nào vượt quá phạm vi được chấp nhận cho đối số đó, nó sẽ tăng dần đến đơn vị lớn hơn tiếp theo nếu thích hợp. Ví dụ, nếu bạn xác định 35 ngày, nó được đánh giá là một tháng và một số ngày, tùy thuộc vào nơi áp dụng trong năm. Nếu bất kỳ đối số đơn nào nằm ngoài phạm vi từ -32.768 đến 32.767, sẽ xảy ra lỗi. Nếu ngày được chỉ định bởi ba đối số nằm ngoài phạm vi ngày được chấp nhận, sẽ xảy ra lỗi.
Lưu ý: Đối với năm, tháng và ngày, nếu cài đặt thuộc tính Lịch là lịch Gregory, thì giá trị được cung cấp được giả định là lịch Gregory. Nếu cài đặt thuộc tính Calendar là Hijri, giá trị được cung cấp được giả định là Hijri.
Phần ngày trả về là theo đơn vị khoảng thời gian của lịch Visual Basic hiện tại. Ví dụ, nếu lịch hiện tại là Hijri và phần ngày được trả về là năm, giá trị năm là năm Hijri. Đối với năm đối số, các giá trị từ 0 đến 99, bao gồm cả 0 và 99, được diễn giải là năm 1400-1499. Đối với tất cả các giá trị năm khác, hãy dùng năm có bốn chữ số hoàn chỉnh (ví dụ: 1520).
Ví dụ về truy vấn
Biểu thức |
Kết quả |
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
Trả về "ngày" cho năm, tháng và ngày đã xác định được nhập vào các đối số của hàm và hiển thị trong cột "Ngày_Mới". Kết quả: "12/13/2018". |
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, chọn Tham khảo dành cho Nhà phát triển trong danh sách thả xuống cạnh Tìm kiếm, rồi nhập một hoặc nhiều từ vào hộp tìm kiếm.
Ví dụ này sử dụng hàm DateSerial để trả về ngày cho năm, tháng và ngày đã xác định.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.