มีการอธิบาย DatePart ในคู่มืออ้างอิง ASP (VBScript) แต่คำอธิบายของพารามิเตอร์แรกนั้นเขียนเกินไปและทำให้เข้าใจผิด เราจะอธิบายอีกครั้ง
ไวยากรณ์ของ DatePart คือ DatePart(interval, date) ซึ่งใช้เพื่อรับส่วนหนึ่งของวันที่
ช่วงเวลา
ปปปป: ปีในวันที่
m: เดือนในวันที่
d: วันแล้ววันเล่า
h: ชั่วโมงในวันที่
n: นาทีในวันที่
s: วินาทีในวันที่
ถาม: วันที่อยู่ในไตรมาสใดของปี เช่น 29-6-2552 อยู่ในไตรมาสที่สอง
y: วันที่คือวันที่ของปี เช่น 29-6-2552 ตรงกับวันที่ 180
w: วันที่คือวันในสัปดาห์ (วันอาทิตย์เป็นวันแรกตามค่าเริ่มต้น) เช่น 2009-6-29 เป็นวันที่ 2
ww: วันที่อยู่ในสัปดาห์ของปี เช่น 2009-6-29 อยู่ในสัปดาห์ที่ 27
DatePart(ช่วง, วันที่[, firstdayofweek[, firstweekofyear]])
ไวยากรณ์ของฟังก์ชัน DatePart มีพารามิเตอร์ต่อไปนี้:
คำอธิบายพารามิเตอร์
จำเป็นต้องมีช่วงเวลา นิพจน์สตริงที่แสดงถึงช่วงเวลาที่จะถูกส่งกลับ ดูส่วนการตั้งค่าสำหรับค่าต่างๆ
ต้องระบุวันที่ นิพจน์วันที่ที่จะประเมิน
เป็นตัวเลือกวันแรกของสัปดาห์ ค่าคงที่ที่ระบุวันแรกของสัปดาห์ หากไม่ได้ระบุ ระบบจะใช้ค่าเริ่มต้นเป็นวันอาทิตย์ ดูส่วนการตั้งค่าสำหรับค่าต่างๆ
สัปดาห์แรกของปี ไม่บังคับ ค่าคงที่ที่ระบุสัปดาห์แรกของปี หากไม่ได้ระบุ ระบบจะใช้ค่าเริ่มต้นเป็นสัปดาห์ของวันที่ 1 มกราคม ดูส่วนการตั้งค่าสำหรับค่าต่างๆ
พารามิเตอร์ช่วงเวลาสามารถตั้งค่าเป็นค่าต่อไปนี้:
คำอธิบายการตั้งค่า
เย้ ปี
คิวไตรมาส
เดือน
y จำนวนวันในหนึ่งปี
ดีวัน
วันในสัปดาห์
สัปดาห์
ชม
เมตร นาที
วินาที
พารามิเตอร์ firstdayofweek สามารถมีค่าต่อไปนี้:
คำอธิบายค่าคงที่
vbUseSystem 0 ใช้การตั้งค่า API การสนับสนุนภาษาประจำชาติ (NLS)
vbวันอาทิตย์ 1 วันอาทิตย์ (ค่าเริ่มต้น)
vbวันจันทร์ที่ 2 วันจันทร์
vbวันอังคารที่ 3 วันอังคาร
vbวันพุธที่ 4 วันพุธ
vbวันพฤหัสบดีที่ 5 วันพฤหัสบดี
vbวันศุกร์ที่ 6 วันศุกร์
vbวันเสาร์ที่ 7 วันเสาร์
พารามิเตอร์ firstweekofyear สามารถมีค่าต่อไปนี้:
คำอธิบายค่าคงที่
vbUseSystem 0 ใช้การตั้งค่า API การสนับสนุนภาษาประจำชาติ (NLS)
vbFirstJan1 1 เริ่มต้นด้วยสัปดาห์ของวันที่ 1 มกราคม (ค่าเริ่มต้น)
vbFirstFourDays 2 เริ่มต้นด้วยสัปดาห์แรกของปีใหม่ที่มีอย่างน้อยสี่วัน
vbFirstFullWeek 3 เริ่มต้นด้วยสัปดาห์แรกของปีใหม่เต็ม (ไม่ใช่ข้ามปี)
แสดงให้เห็น
ฟังก์ชัน DatePart จะคำนวณวันที่และส่งกลับช่วงเวลาที่ระบุ ตัวอย่างเช่น ใช้ DatePart เพื่อคำนวณวันในสัปดาห์หรือเวลาปัจจุบันของวันใดวันหนึ่ง
พารามิเตอร์ firstdayofweek ส่งผลต่อการคำนวณโดยใช้สัญลักษณ์ช่วง "w" และ "ww"
ถ้า date เป็นวันที่ตามตัวอักษร ปีที่ระบุจะกลายเป็นส่วนที่คงที่ของวันที่ แต่ถ้าวันที่อยู่ในเครื่องหมายคำพูด (" ") และไม่ได้ระบุปี ปีปัจจุบันจะถูกแทรกทุกครั้งที่มีการประเมินนิพจน์วันที่ในโค้ด ทำให้สามารถเขียนโค้ดโปรแกรมที่ทำงานในแต่ละปีได้