Trả về một Biến_thể (Số_nguyên) chứa phần xác định của một ngày cụ thể.
| Cảnh báo Có sự cố khi sử dụng hàm này. Thứ hai cuối cùng trong một số năm dương lịch có thể được trả về là tuần 53, trong khi đáng ra phải là tuần 1. Để biết thêm thông tin và giải pháp thay thế, hãy xem hàm Format hoặc DatePart có thể trả về số tuần sai cho thứ Hai cuối cùng trong Năm. |
|---|
Cú pháp
DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )
Cú pháp hàm DatePart có các đối số sau:
| Đối số | Mô tả |
|---|---|
| khoảng thời gian | Bắt buộc. Biểu thức chuỗi là khoảng thời gian bạn muốn trả về. |
| ngày | Bắt buộc. Giá trị Biến_thể (Ngày) mà bạn muốn đánh giá. |
| ngày_đầu_tiên_của_tuần | Không bắt buộc. Hằng số xác định ngày đầu tiên của tuần. Nếu không được xác định, sẽ giả định là Chủ Nhật. |
| tuần_đầu_tiên_của_năm | Không bắt buộc. Một hằng số xác định tuần đầu tiên của năm. Nếu không được xác định, giả định tuần đầu tiên của năm là tuần có ngày 01 Tháng Một. |
Cài đặt
Đối số khoảng thời gian có những 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 |
Đối số ngày_đầu_tiên_của_tuần có các thiết đặt sau đây:
| Hằng số | Value | Mô tả |
|---|---|---|
| vbUseSystem | 0 | Sử dụng cài đặt NLS API. |
| vbSunday | 1 | Chủ nhật (mặc định) |
| vbThứ Hai | 2 | Thứ Hai |
| vbTuesday | 3 | Thứ ba |
| vbThứ Tư | 4 | Thứ Tư |
| vbThursday | 5 | Thứ Năm |
| Thứ Sáu vb | 6 | Thứ Sáu |
| vbSaturday | 7 | Thứ Bảy |
Đối số tuần_đầu_tiên_của_năm có các cài đặt sau đây:
| Hằng số | Value | Mô tả |
|---|---|---|
| vbUseSystem | 0 | Sử dụng cài đặt NLS API. |
| vbFirstJan1 | 1 | Bắt đầu với tuần có ngày 01 Tháng Một (mặc định). |
| vbFirstFourDays | 2 | Bắt đầu với tuần đầu tiên có ít nhất bốn ngày trong năm mới. |
| vbFirstFullWeek | 3 | Bắt đầu với tuần đầy đủ đầu tiên trong năm. |
Chú thích
Bạn có thể sử dụng hàm DatePart để đánh giá một ngày và trả về một khoảng thời gian cụ thể. Ví dụ: bạn có thể sử dụng DatePart để tính toán ngày trong tuần hoặc giờ hiện tại.
Đối số ngày_đầu_tiên_của_tuần ảnh hưởng đến các phép tính sử dụng các ký hiệu khoảng "w" và "ww".
Nếu date là dạng chữ ngày, năm được chỉ định sẽ trở thành một phần vĩnh viễn của ngày đó. Tuy nhiên, nếu ngày được đặt trong dấu ngoặc kép (" ") và bạn bỏ qua năm, năm hiện tại sẽ được chèn vào mã của bạn mỗi lần biểu thức ngày được đánh giá. Điều này giúp bạn có thể viết mã có thể sử dụng trong các năm khác nhau.
Lưu ý
Đối với ngày, nếu cài đặt thuộc tính Calendar là Dương lịch, ngày được cung cấp phải là Dương lịch. Nếu lịch là lịch Hijri, ngày được cung cấp phải là Hijri.
Phần ngày được trả về là theo đơn vị khoảng thời gian của lịch Ả Rập 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.
Ví dụ về truy vấn
| Biểu thức | Kết quả |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | Trả về 'Năm' của các giá trị ngày cho trường "Ngày_Sản_xuất". |
| SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | Trả về 'Quý' (dựa trên năm lịch) của các giá trị ngày cho trường "Ngày_Bán". |
| SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | Trả về 'Ngày trong Năm' (1 đến 365) của các giá trị ngày của trường "Ngày_Bán_thu". |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | Trả về 'Ngày' của các giá trị ngày cho trường "Ngày_Sản_xuất". |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | Trả về 'Weekday' (từ 1 đến 7, trong đó 1 biểu thị Chủ nhật) của giá trị ngày cho trường "DateofSale". |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | Trả về 'Số tuần' (từ 1 đến 52) của giá trị ngày của trường "Ngày_ủa_Bán". |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | Trả về 'Giờ' của các giá trị ngày cho trường "DateTime". |
| SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | Trả về 'Phút' của các giá trị ngày cho trường "DateTime". |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | Trả về 'giây' của các giá trị ngày cho trường "DateTime". |
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 lấy một ngày và sử dụng hàm DatePart để hiển thị quý trong năm mà ngày đó diễn ra.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg