ฟังก์ชัน DateValue, TimeValue และ DateTimeValue

  • บทความ

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

แปลงวันที่ เวลา หรือทั้งสองอย่างใน สตริง เป็นค่า วันที่/เวลา

คำอธิบาย

  • ฟังก์ชัน DateValue จะแปลง สตริงวันที่ (ตัวอย่างเช่น “10/01/2014”) เป็นค่า วันที่/เวลา

  • ฟังก์ชัน TimeValue จะแปลง สตริงเวลา (ตัวอย่างเช่น “12:15 PM”) เป็นค่า วันที่/เวลา

  • ฟังก์ชัน DateTimeValue จะแปลง สตริงวันที่และเวลา (ตัวอย่างเช่น “10 มกราคม 2013 12:13 AM”) เป็นค่า วันที่/เวลา

ฟังก์ชัน DateValue จะละเว้นข้อมูลเวลาในสตริงวันที่ และฟังก์ชัน TimeValue จะละเว้นข้อมูลวันที่ในสตริงเวลา

หมายเหตุ

ฟังก์ชัน DateValue TimeValue และ DateTimeValue โดยค่าเริ่มต้นใช้ภาษาจากการตั้งค่าของผู้ใช้ปัจจุบัน คุณสามารถแทนที่ได้เพื่อให้แน่ใจว่าสตริงนั้นถูกตีความอย่างเหมาะสม ตัวอย่างเช่น “10/1/1920” จะแปลเป็น 1 ตุลาคมst ใน "en" และแปลเป็น 10 มกราคมth ใน "fr"

วันที่ต้องเป็นหนึ่งในรูปแบบเหล่านี้:

  • MM/DD/YYYY หรือ MM-DD-YYYY
  • DD/MM/YYYY หรือ DD-MM-YYYY
  • YYYY/MM/DD หรือ YYYY-MM-DD
  • MM/DD/YY หรือ MM-DD-YY
  • DD/MM/YY หรือ DD-MM-YY
  • DD Mon YYYY
  • Month DD, YYYY

การแปลงจากองค์ประกอบ วันที่ เดือน และปี วันที่ จากตัวเลข ให้อ่าน Date
การแปลงจากองค์ประกอบ ชั่วโมง นาที และวินาที จากตัวเลข ให้อ่าน Time

สำหรับข้อมูลเพิ่มเติม อ่าน:

ไวยากรณ์

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

  • สตริง - จำเป็น สตริงข้อความที่มีวันที่ เวลา หรือข้อมูลผสมของค่าวันที่และเวลา
  • Language - ไม่จำเป็น สตริงภาษา เช่น ส่งกลับตามอักขระสองตัวแรกจากฟังก์ชัน Language ถ้าไม่มี จะใช้ภาษาของการตั้งค่าของผู้ใช้ปัจจุบัน

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped - จำเป็น ออบเจ็กต์ไม่ระบุชนิด ที่แสดงถึงวันที่หรือเวลา ค่าที่ยอมรับได้ขึ้นอยู่กับตัวให้บริการไม่ระบุชนิด สำหรับ JSON ออบเจ็กต์ไม่ระบุชนิดคาดว่าจะเป็นสตริง JSON ที่มีวันที่และเวลาในรูปแบบ ISO 8601 วันที่หรือเวลาในรูปแบบอื่นจะทำให้เกิดข้อผิดพลาด พิจารณาแปลงค่าดังกล่าวเป็น Text ก่อน แล้วจึงแปลงเป็นวันที่หรือเวลา โปรดทราบว่าโซนเวลาและรูปแบบที่เกี่ยวข้องกับที่ตั้งเป็นข้อพิจารณาที่สำคัญเมื่อสื่อสารกับระบบภายนอก

ตัวอย่าง

DateValue

ถ้าคุณพิมพ์ 10/11/2014 ในตัวควบคุมการป้อนข้อความที่ชื่อว่า วันที่เริ่มต้น แล้วตั้งค่าคุณสมบัติ Text ของป้ายกำกับเป็นสูตรนี้:

  • แปลงวันที่จากสตริงในตำแหน่งที่ตั้งของผู้ใช้ และแสดงผลเป็นวันที่แบบยาว

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    ตั้งค่าอุปกรณ์เป็น en แสดงป้ายกำกับเป็น วันเสาร์ที่ 11 ตุลาคม 2014

    หมายเหตุ

    คุณสามารถใช้หลายตัวเลือกด้วย enum DateTimeFormat การแสดงรายการตัวเลือก ให้พิมพ์พารามิเตอร์ตามด้วยจุด (.) ในแถบสูตร หรือตรวจสอบ การอ้างอิงฟังก์ชัน Text

  • แปลงวันที่จากสตริงในตำแหน่งที่ตั้งของฝรั่งเศส และแสดงผลเป็นวันที่แบบยาว ในตัวอย่างนี้ เดือนและวันที่ของเดือนจะถูกตีความแตกต่างจากภาษาอังกฤษ

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    ตั้งค่าอุปกรณ์เป็น en แสดงป้ายกำกับเป็น วันจันทร์ที่ 10 พฤศจิกายน 2014

ถ้าคุณพิมพ์ 20 ตุลาคม 2014 แทน:

  • แปลงวันที่จากสตริงในตำแหน่งที่ตั้งของผู้ใช้ และคำนวณความแตกต่างระหว่างสองวัน เป็นวัน

    DateDiff( DateValue( Startdate.Text ), Today() )

    ตั้งค่าอุปกรณ์เป็น en แสดงป้ายกำกับเป็น 9 ระบุจำนวนวันระหว่างวันที่ 11 ตุลาคม ถึง 20 ตุลาคม ฟังก์ชัน DateDiff ยังสามารถแสดงความแตกต่างเป็นเดือน ไตรมาส หรือปีได้

DateTimeValue

ถ้าคุณพิมพ์ 10/11/2014 1:50:24.765 PM ในตัวควบคุมการป้อนข้อความที่ชื่อว่า เริ่มต้น แล้วตั้งค่าคุณสมบัติ Text ของป้ายกำกับเป็นนี้:

  • แปลงทั้งสตริงวันที่และเวลาในสถานที่ปัจจุบัน

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    ตั้งค่าอุปกรณ์เป็น en แสดงป้ายกำกับเป็น วันเสาร์ที่ 11 ตุลาคม 2014 1:50:24 PM

    หมายเหตุ

    คุณสามารถใช้หลายตัวเลือกด้วย enum DateTimeFormat การแสดงรายการตัวเลือก ให้พิมพ์พารามิเตอร์ตามด้วยจุด (.) ในแถบสูตร หรือตรวจสอบ การอ้างอิงฟังก์ชัน Text

  • แปลงทั้งสตริงวันที่และเวลาในตำแหน่งที่ตั้งฝรั่งเศส เดือนและวันของเดือนนั้นตีความต่างกัน

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    ตั้งค่าอุปกรณ์เป็น en แสดงป้ายกำกับเป็น วันจันทร์ที่ 10 พฤศจิกายน 2014 1:50:24 PM

  • แปลงทั้งสตริงวันที่และเวลาในสถานที่ของผู้ใช้ และแสดงผลลัพธ์ด้วยเสี้ยววินาที

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    ตั้งค่าอุปกรณ์เป็น en แสดงป้ายกำกับเป็น วันเสาร์ที่ 11 ตุลาคม 2014 01:50:24.765 PM

    อีกทางเลือกหนึ่งคือ คุณสามารถระบุ hh:mm:ss.f หรือ hh:mm:ss.ff เพื่อปัดเศษเวลาเป็นวินาทีที่ 10 หรือที่ 100 ที่ใกล้เคียงที่สุด

TimeValue

ตั้งชื่อตัวควบคุมการป้อนข้อความ FinishedAt แล้วตั้งค่าคุณสมบัติ Text ของป้ายกำกับเป็นสูตรนี้:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • ถ้าคุณพิมพ์ 4:59:59.999 PM ลงในตัวควบคุม FinishedAt ป้ายกำกับจะแสดง "คุณมาทันเวลา!"
  • ถ้าคุณพิมพ์ 5:00:00.000 PM ลงในตัวควบคุม FinishedAt ป้ายกำกับจะแสดง "สายไปแล้ว!"