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(năm, tháng, ngày)
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. Tham đối không hợp lệ có thể dẫn đến kết quả không đúng.
Cú pháp hàm DateSerial có các đối số sau:
| Đối số | Mô tả |
|---|---|
| năm | Bắt buộc. Số nguyên. Các số từ 100 đến hết 9999 hoặc một 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 đối số DateSerial phải nằm trong phạm vi được chấp nhận cho đơn vị; tức là, 1-31 cho ngày và 1-12 cho tháng. Tuy nhiên, bạn cũng có thể chỉ định ngày tương đối cho từng đối số bằng cách sử 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 8 (),8 - 2 10 năm trước 1990 ();1990 - 10 nói cách khác là 31 tháng 5 năm 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Năm có hai chữ số cho đối số năm được diễn giải dựa trên cài đặt máy do người dùng xác định. Cài đặt mặc định là các giá trị nằm trong khoảng từ 0 tới hết 29 được hiểu là các 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 sử dụng năm gồm bốn chữ số (ví dụ, 1800).
Các phiên bản Windows cũ hơn Windows 2000 diễn giải các năm có hai chữ số dựa trên các giá trị mặc định được mô tả ở trên. Để đảm bảo hàm trả về giá trị phù hợp, hãy sử dụng năm gồm bốn chữ số.
Khi bất kỳ đối số nào vượt quá phạm vi chấp nhận cho đối số đó, đối số sẽ tăng dần đến đơn vị lớn hơn tiếp theo tùy trường hợp. Ví dụ, nếu bạn xác định 35 ngày, thì nó được đánh giá là một tháng và một số ngày cụ thể, tùy thuộc vào vị trí trong năm áp dụng đó. Nếu bất kỳ đối số đơn nào nằm ngoài phạm vi -32.768 đến 32.767, lỗi sẽ xuất hiện. Nếu ngày được xác định bởi ba đối số này 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 thiết đặt thuộc tính Calendar là Gregorian, giá trị được cung cấp được giả định là Dương lịch. 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 được trả về nằm 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à Lịch Hijri và phần ngày được trả về là năm, thì giá trị năm là năm Hijri. Đối với đối số năm, các giá trị từ 0 đến hết 99 được hiểu là các 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ố đầy đủ (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, ngày đã xác định được nhập trong các đối số của hàm và hiển thị trong cột "NewDate". Kết quả: "13/12/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.