ฟังก์ชัน Date, DateTime และ Time

ใช้กับ: แอปพื้นที่ทำงาน โฟลว์เดสก์ท็อป แอปแบบจำลอง Power Pages Power Platform CLI

แปลงส่วนประกอบของวันที่และเวลาให้เป็นค่าวันที่/เวลา

Description

ฟังก์ชัน Date จะแปลงค่าของ ปี เดือน และวันที่ แต่ละค่า ให้เป็นค่าวันที่/เวลา ส่วนเวลาคือ เที่ยงคืน

• ถ้าปีคือระหว่าง 0 และ 1899 (แบบครอบคลุม) ฟังก์ชันจะเติมค่านั้นให้เป็น 1900 เพื่อคำนวนหาปี 70 จะกลายเป็น 1970
• ถ้าเดือนมีค่าน้อยกว่า 1 หรือมากกว่า 12 ผลลัพท์จะลบหรือบวกเพิ่มเวลาหลายเดือนนั้นนับตั้งแต่ต้นปีของปีที่ระบุ
• ถ้าวันที่มีค่ามากกว่าจำนวนวันในเดือนที่ระบุไว้ ฟังก์ชันจะเพิ่มวันเหล่านั้นไปยังวันแรกของเดือน และส่งกลับวันที่สอดคล้องกันจากหนึ่งเดือนถัดไป ถ้าวันมีค่าน้อยกว่า 1 ฟังก์ชันจะลบวันเหล่านั้น แล้วบวก 1 นับจากวันแรกของเดือนที่ระบุ

ฟังก์ชัน Time จะแปลงค่าของชั่วโมง นาที วินาที และมิลลิวินาทีแต่ละค่าให้เป็นค่าวันที่/เวลา ผลลัพธ์ที่ได้จะไม่เชื่อมโยงกับวันที่

ฟังก์ชัน DateTime จะรวม Date และ Time ให้เป็นฟังก์ชันเดียว โดยรับทั้งอาร์กิวเมนต์วันที่และเวลาและส่งกลับค่าวันที่/เวลาที่มีทั้งส่วนประกอบวันที่และเวลา

ดูฟังก์ชัน DateValue TimeValue และ DateTimeValue สำหรับข้อมูลเกี่ยวกับวิธีการแปลงสตริให้เป็นค่า

ดูที่ การทำงานกับวันที่และเวลา สำหรับข้อมูลเพิ่มเติม

ไวยากรณ์

Date( Year, Month, Day )

• ปี- จำเป็นต้องมี ตัวเลขที่มากกว่า 1899 จะถูกตีความเป็นค่าสัมบูรณ์ (1980 ถูกตีความเป็น 1980); ตัวเลขที่อยู่ในช่วงตั้งแต่ 0 ถึง 1899 จะถูกตีความว่าเกี่ยวข้องกับ 1900 (ตัวย่างเช่น 80 จะถูกตีความเป็น 1980)
• เดือน- จำเป็นต้องมี ตัวเลขในช่วงตั้งแต่ 1 ถึง 12
• วัน - จำเป็นต้องมี ตัวเลขในช่วงตั้งแต่ 1 ถึง 31

Time( Hour, Minute, Second [, Milliseconds ] )

• ชั่วโมง - จำเป็นต้องมี จำนวนชั่วโมง โดยปกติจะอยู่ในช่วง 0 (00:00 น.) ถึง 23 (23:00 น.)
• นาที- จำเป็นต้องมี จำนวนของนาที โดยปกติจะอยู่ในช่วง 0 ถึง 59
• วินาที- จำเป็นต้องมี จำนวนของวินาที โดยปกติจะอยู่ในช่วง 0 ถึง 59
• มิลลิวินาที - ไม่จำเป็น จำนวนของมิลลิวินาที โดยปกติจะอยู่ในช่วง 0 ถึง 999

DateTime( Year, Month, Day, Hour, Minute, Second [, Milliseconds ] )

• ปี- จำเป็นต้องมี ตัวเลขที่มากกว่า 1899 จะถูกตีความเป็นค่าสัมบูรณ์ (1980 ถูกตีความเป็น 1980); ตัวเลขที่อยู่ในช่วงตั้งแต่ 0 ถึง 1899 จะถูกตีความว่าเกี่ยวข้องกับ 1900 (ตัวย่างเช่น 80 จะถูกตีความเป็น 1980)
• เดือน- จำเป็นต้องมี ตัวเลขในช่วงตั้งแต่ 1 ถึง 12
• วัน - จำเป็นต้องมี ตัวเลขในช่วงตั้งแต่ 1 ถึง 31
• ชั่วโมง - จำเป็นต้องมี จำนวนชั่วโมง โดยปกติจะอยู่ในช่วง 0 (00:00 น.) ถึง 23 (23:00 น.)
• นาที- จำเป็นต้องมี จำนวนของนาที โดยปกติจะอยู่ในช่วง 0 ถึง 59
• วินาที- จำเป็นต้องมี จำนวนของวินาที โดยปกติจะอยู่ในช่วง 0 ถึง 59
• มิลลิวินาที - ไม่จำเป็น จำนวนของมิลลิวินาที โดยปกติจะอยู่ในช่วง 0 ถึง 999

ตัวอย่าง

Date

หากผู้ใช้พิมพ์

• 1979 ในตัวควบคุมการป้อนข้อความชื่อ HireYear
• 3 ในตัวควบคุมการป้อนข้อความชื่อ HireMonth
• 17 ในตัวควบคุมการป้อนข้อความชื่อ HireDay

สูตรนี้จะส่งกลับค่า 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

เวลา

หากผู้ใช้พิมพ์

• 14 ในตัวควบคุมการป้อนข้อความชื่อ BirthHour
• 50 ในตัวควบคุมการป้อนข้อความชื่อ BirthMinute
• 24 ในตัวควบคุมการป้อนข้อความชื่อ BirthSecond

สูตรนี้จะส่งกลับค่า 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

DateTime

หากผู้ใช้พิมพ์

• 2023 ในตัวควบคุมการป้อนข้อความชื่อ EclipseYear
• 10 ในตัวควบคุมการป้อนข้อความชื่อ EclipseMonth
• 28 ในตัวควบคุมการป้อนข้อความชื่อ EclipseDate
• 13 ในตัวควบคุมการป้อนข้อความชื่อ EclipseHour
• 14 ในตัวควบคุมการป้อนข้อความชื่อ EclipseMinute
• 5 ในตัวควบคุมการป้อนข้อความชื่อ EclipseSecond
• 231 ในตัวควบคุมการป้อนข้อความชื่อ EclipseMillisecond

สูตรนี้จะส่งกลับค่า 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)