DATEADD

นําไปใช้กับ:การคํานวณคอลัมน์จากการคํานวณ ตารางจากการคํานวณ หน่วยวัดการคํานวณวิชวล

หมายเหตุ

ฟังก์ชันนี้ไม่สนับสนุนสําหรับใช้ในการ คํานวณวิชวล เนื่องจากอาจแสดงผลลัพธ์ที่ไม่มีความหมาย

แสดงตารางที่มีคอลัมน์วันที่ เลื่อนไปข้างหน้าหรือย้อนกลับตามเวลาตามจํานวนช่วงเวลาที่ระบุจากวันที่ในบริบทปัจจุบัน

ไวยากรณ์

DATEADD(<dates>,<number_of_intervals>,<interval>)  

พารามิเตอร์

เงื่อนไข คำนิยาม
วัน คอลัมน์ที่มีวันที่
number_of_intervals จํานวนเต็มที่ระบุจํานวนช่วงที่จะเพิ่มหรือลบออกจากวันที่
ช่วง ช่วงเวลาที่จะเปลี่ยนวันที่ ค่าสําหรับช่วงอาจเป็นหนึ่งในรายการต่อไปนี้: year, , quarter, monthday

ค่าที่ส่งกลับ

ตารางที่มีคอลัมน์ของค่าวันที่เดียว

หมายเหตุ

อาร์กิวเมนต์ วันที่ อาจเป็นรายการใดรายการหนึ่งต่อไปนี้:

  • การอ้างอิงถึงคอลัมน์วันที่/เวลา

  • นิพจน์ตารางที่แสดงคอลัมน์ของค่าวันที่/เวลาหนึ่งคอลัมน์

  • นิพจน์บูลีนที่กําหนดตารางคอลัมน์เดียวของค่าวันที่/เวลา

    หมายเหตุ

    ข้อจํากัดของนิพจน์บูลีนจะอธิบายในหัวข้อ ฟังก์ชัน CALCULATE

  • หากตัวเลขที่ระบุสําหรับ number_of_intervals เป็นค่าบวก ระบบจะเปลี่ยนวันที่ใน วันที่ เป็นเวลาในอนาคต หากจํานวนเป็นค่าลบ วันที่ใน วันที่ จะเปลี่ยนเป็นเวลาในไทม์

  • พารามิเตอร์ ช่วง คือการแจงนับ ไม่ใช่ชุดของสตริง จึงไม่ควรมีการแนบค่าในเครื่องหมายอัญประกาศ นอกจากนี้ ควรสะกดค่า: year, , quartermonth, day แบบเต็ม ขณะใช้งาน

  • ตารางผลลัพธ์มีเฉพาะวันที่ที่มีอยู่ในคอลัมน์ วันที่

  • ถ้าวันที่ในบริบทปัจจุบันไม่ได้กําหนดช่วงเวลาที่ติดกัน ฟังก์ชันจะแสดงข้อผิดพลาด

  • ฟังก์ชันนี้ไม่ได้รับการสนับสนุนสําหรับการใช้งานในโหมด DirectQuery เมื่อใช้ในคอลัมน์จากการคํานวณหรือกฎการรักษาความปลอดภัยระดับแถว (RLS)

ตัวอย่าง - การเลื่อนชุดวันที่

สูตรต่อไปนี้จะคํานวณวันที่เป็นหนึ่งปีก่อนวันที่ในบริบทปัจจุบัน

= DATEADD(DateTime[DateKey],-1,year)  

ฟังก์ชันตัวแสดงเวลา
ฟังก์ชันวันที่และเวลา