สตริงรูปแบบวันที่และเวลาแบบกําหนดเอง

สตริงรูปแบบวันที่และเวลาจะกําหนดการแสดงข้อความของวันที่ วันที่เวลา โซนวันที่เวลา หรือเวลาซึ่งเป็นผลลัพธ์จากการดําเนินการจัดรูปแบบ นอกจากนี้ยังสามารถกําหนดการแทนค่าวันที่และเวลาที่จําเป็นในการดําเนินการแยกวิเคราะห์เพื่อให้แปลงสตริงเป็นวันที่และเวลาได้สําเร็จ สตริงรูปแบบแบบกําหนดเองประกอบด้วยตัวระบุรูปแบบวันที่และเวลาแบบกําหนดเองอย่างน้อยหนึ่งตัว สตริงใด ๆ ที่ไม่ใช่ สตริง รูปแบบวันที่และเวลามาตรฐานจะถูกแปลเป็นสตริงรูปแบบวันที่และเวลาที่กําหนดเอง

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

let
    Source = 
    {
        Text.From("Today is " & Date.ToText(#date(2011, 6, 10), [Format = "MMMM dd yyyy"]) & "."),
        Text.Format("The current date and time: #{0}", {DateTimeZone.ToText(
            #datetimezone(2011, 6, 10, 15, 24, 16, 0, 0), [Format = "MM/dd/yy H:mm:ss zzz"])}
        )
    }
in
    Source

// The example displays the following output:
//    Today is June 10, 2011.
//    The current date and time: 06/10/11 15:24:16 +00:00

ในการดําเนินการแยกวิเคราะห์ คุณสามารถใช้สตริงรูปแบบวันที่และเวลาแบบกําหนดเองกับ ฟังก์ชัน Date, DateTime, Time และ DateTimeZone ได้ ฟังก์ชันเหล่านี้กําหนดให้สตริงที่ป้อนเข้าสอดคล้องกับรูปแบบเฉพาะเพื่อให้การดําเนินการแยกวิเคราะห์สําเร็จ ตัวอย่างต่อไปนี้แสดงการเรียกใช้ไปยังฟังก์ชัน DateTime.FromText เพื่อแยกวิเคราะห์วันที่ที่ต้องประกอบด้วยเดือน วัน และปีที่มีสองหลัก

let
    dateValues = { "30-12-2011", "12-30-2011", "30-12-11", "12-30-11"},
    pattern = "MM-dd-yy",
    convertedDates = List.Transform(dateValues, (dateValue) => 
        try Text.Format("Converted '#{0}' to #{1}.", {dateValue, DateTime.FromText(dateValue, [Format=pattern])}) 
        otherwise Text.Format("Unable to convert '#{0}' to a date and time.", {dateValue}))
in
    convertedDates

// The example displays the following output:
//    Unable to convert '30-12-2011' to a date and time.
//    Unable to convert '12-30-2011' to a date and time.
//    Unable to convert '30-12-11' to a date and time.
//    Converted '12-30-11' to 12/30/2011.

ตารางต่อไปนี้อธิบายตัวระบุรูปแบบวันที่และเวลาแบบกําหนดเองและแสดงสตริงผลลัพธ์ที่สร้างขึ้นโดยตัวระบุรูปแบบแต่ละรูปแบบ ตามค่าเริ่มต้น สตริงผลลัพธ์จะแสดงรูปแบบของวัฒนธรรม en-US หากตัวระบุรูปแบบเฉพาะสร้างสตริงผลลัพธ์ที่แปลเป็นภาษาท้องถิ่น ตัวอย่างจะบันทึกวัฒนธรรมที่ใช้กับสตริงผลลัพธ์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้สตริงรูปแบบวันที่และเวลาแบบกําหนดเอง ให้ไปที่ส่วนหมายเหตุ

ตัวระบุรูปแบบ	คำอธิบาย	ตัวอย่าง
"d"	วันของเดือนจาก 1 ถึง 31 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "d"	2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 -> 15
"dd"	วันของเดือนจาก 01 ถึง 31 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "dd"	2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 -> 15
"ddd"	ชื่อย่อของวันในสัปดาห์ ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "ddd"	2009-06-15T13:45:30 -> จันทร์ (en-US) 2009-06-15T13:45:30 -> Пн (ru-RU) 2009-06-15T13:45:30 -> lun (fr-FR)
"dddd"	ชื่อเต็มของวันในสัปดาห์ ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "dddd"	2009-06-15T13:45:30 -> วันจันทร์ (en-US) 2009-06-15T13:45:30 -> понедельник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR)
"f"	ค่าสิบของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "f"	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0
"ff"	ส่วนร้อยของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบแบบกําหนดเอง "ff"	2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> 00
"fff"	หน่วยมิลลิวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "fff"	6/15/2009 13:45:30.617 -> 617 6/15/2009 13:45:30.0005 -> 000
"ffff"	จํานวนสิบพันวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบแบบกําหนดเอง "ffff"	2009-06-15T13:45:30.6175000 -> 6175 2009-06-15T13:45:30.0000500 -> 0000
"fffff"	จํานวนร้อยพันวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "fffff"	2009-06-15T13:45:30.6175400 -> 61754 6/15/2009 13:45:30.000005 -> 00000
"ffffff"	ล้านวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "ffffff"	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> 000000
"fffffff"	ค่าสิบล้านวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "fffffff"	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150
"F"	ถ้าไม่เป็นศูนย์ ค่าสิบของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "F"	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 (> ไม่มีเอาต์พุต)
"FF"	ถ้าไม่ใช่ศูนย์ ส่วนร้อยของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบแบบกําหนดเอง "FF"	2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> (ไม่มีเอาต์พุต)
"FFF"	หากไม่ใช่ศูนย์ หน่วยมิลลิวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "FFF"	2009-06-15T13:45:30.6170000 -> 617 2009-06-15T13:45:30.0005000 -> (ไม่มีเอาต์พุต)
"FFFF"	ถ้าไม่เป็นศูนย์ หลักสิบพันของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบแบบกําหนดเอง "FFFF"	2009-06-15T13:45:30.5275000 -> 5275 2009-06-15T13:45:30.0000500 -> (ไม่มีเอาต์พุต)
"FFFFF"	ถ้าไม่เป็นศูนย์ ค่าร้อยพันของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "FFFFF"	2009-06-15T13:45:30.6175400 -> 61754 2009-06-15T13:45:30.0000050 -> (ไม่มีเอาต์พุต)
"FFFFFF"	ถ้าไม่ใช่ศูนย์ ส่วนล้านของวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "FFFFFF"	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> (ไม่มีเอาต์พุต)
"FFFFFFF"	ถ้าไม่ใช่ศูนย์ สิบล้านวินาทีในค่าวันที่และเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "FFFFFFF"	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115
"g", "gg"	รอบระยะเวลาหรือศักราช ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "g" หรือ "gg"	2009-06-15T13:45:30.6170000 -> A.D.
"h"	ชั่วโมงโดยใช้นาฬิกาแบบ 12 ชั่วโมงตั้งแต่ 1 ถึง 12 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "h"	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1
"hh"	ชั่วโมงโดยใช้นาฬิกาแบบ 12 ชั่วโมงตั้งแต่ 01 ถึง 12 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "hh"	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01
"H"	ชั่วโมงโดยใช้นาฬิกาแบบ 24 ชั่วโมงตั้งแต่ 0 ถึง 23 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "H"	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 13
"HH"	ชั่วโมงโดยใช้นาฬิกาแบบ 24 ชั่วโมงตั้งแต่ 00 ถึง 23 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "HH"	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 13
"K"	ข้อมูลโซนเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "K"	2009-06-15T13:45:30, ไม่ได้ระบุ -> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, ท้องถิ่น -> -07:00 (ขึ้นอยู่กับการตั้งค่าคอมพิวเตอร์ในเครื่องหรือระบบคลาวด์)
"m"	นาทีจาก 0 ถึง 59 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "m"	2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 -> 29
"mm"	นาทีจาก 00 ถึง 59 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "mm"	2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45
"M"	เดือนจะเริ่มต้นจาก 1 ถึง 12 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "M"	2009-06-15T13:45:30 -> 6
"MM"	เดือนจะเริ่มต้นที่ 01 ถึง 12 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "MM"	2009-06-15T13:45:30 -> 06
"MMM"	ชื่อย่อของเดือน ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "MMM"	2009-06-15T13:45:30 -> มิ.ย. (en-US) 2009-06-15T13:45:30 -> juin (fr-FR) 2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM"	ชื่อเต็มของเดือน ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "MMMM"	2009-06-15T13:45:30 -> มิถุนายน (en-US) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA)
"s"	วินาทีจาก 0 ถึง 59 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "s"	2009-06-15T13:45:09 -> 9
"ss"	วินาทีจาก 00 ถึง 59 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "ss"	2009-06-15T13:45:09 -> 09
"t"	อักขระแรกของตัวกําหนด AM/PM ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "t"	2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
"tt"	ตัวกําหนด AM/PM ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "tt"	2009-06-15T13:45:30 -> PM (en-US) 2009-06-15T13:45:30 -> 午後 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
"y"	ปีตั้งแต่ 0 ถึง 99 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "y"	0001-01-01T00:00:00 -> 1 0900-01-01T00:00:00 -> 0 1900-01-01T00:00:00 -> 0 2009-06-15T13:45:30 -> 9 2019-06-15T13:45:30 -> 19
"yyy"	ในปี 00 ถึง 99 ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "yy"	0001-01-01T00:00:00 -> 01 0900-01-01T00:00:00 -> 00 1900-01-01T00:00:00 -> 00 2019-06-15T13:45:30 -> 19
"yyyy"	ปีที่มีตัวเลขอย่างน้อยสามหลัก ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "yyyy"	0001-01-01T00:00:00 -> 001 0900-01-01T00:00:00 -> 900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009
"yyyy"	ปีเป็นตัวเลขสี่หลัก ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "yyyy"	0001-01-01T00:00:00 -> 0001 0900-01-01T00:00:00 -> 0900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009
"yyyyy"	ปีเป็นตัวเลขห้าหลัก ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "yyyyy"	0001-01-01T00:00:00 -> 00001 2009-06-15T13:45:30 -> 02009
"z"	ค่าชดเชยชั่วโมงจาก UTC โดยไม่มีเลขศูนย์นําหน้า ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "z"	2009-06-15T13:45:30-07:00 -> -7
"zz"	ค่าชดเชยชั่วโมงจาก UTC โดยมีเลขศูนย์นําหน้าสําหรับค่าตัวเลขเดียว ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบแบบกําหนดเอง "zz"	2009-06-15T13:45:30-07:00 -> -07
"zzz"	ค่าออฟเซ็ตชั่วโมงและนาทีจาก UTC ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง "zzz"	2009-06-15T13:45:30-07:00 -> -07:00
":"	ตัวคั่นเวลา ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบที่กําหนดเอง ":"	2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> (it-IT) 2009-06-15T13:45:30 -> : (ja-JP)
"/"	ตัวคั่นวันที่ ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบแบบกําหนดเอง "/"	2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 -> (ar-DZ) 2009-06-15T13:45:30 -> (tr-TR)
"สตริง" 'string'	ตัวคั่นสตริงสัญพจน์ ข้อมูลเพิ่มเติม :สัญพจน์อักขระ	2009-06-15T13:45:30 ("arr:"" h:m) -> arr: 1:45 P 2009-06-15T13:45:30 ('arr:' h:m) -> arr: 1:45 P
%	กําหนดอักขระต่อไปนี้เป็นตัวระบุรูปแบบแบบกําหนดเอง ข้อมูลเพิ่มเติม: ใช้ตัวระบุรูปแบบกําหนดเองตัวเดียว	2009-06-15T13:45:30 (%h) -> 1
\, "", '	ลําดับการหลีก ข้อมูลเพิ่มเติม: สัญพจน์ อักขระและ การใช้ลําดับการหลีกเลี่ยง	2009-06-15T13:45:30 (h \h) -> 1 ชม. 2009-06-15T13:45:30 (h "h"h"") -> 1 h 2009-06-15T13:45:30 (h 'h') -> 1 h
อักขระอื่นๆ	อักขระจะถูกคัดลอกไปยังสตริงผลลัพธ์ไม่เปลี่ยนแปลง ข้อมูลเพิ่มเติม :สัญพจน์อักขระ	2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

ส่วนต่อไปนี้ให้ข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุรูปแบบวันที่และเวลาแบบกําหนดเองแต่ละตัว เว้นแต่ระบุเป็นอย่างอื่น ตัวระบุแต่ละตัวจะสร้างการแสดงสตริงที่เหมือนกันโดยไม่คํานึงว่าจะใช้กับ ค่า Date, DateTime, DateTimeZone หรือ Time หรือไม่

ตัวระบุรูปแบบ "d" วัน

ตัวระบุรูปแบบแบบกําหนดเอง "d"

ตัวระบุรูปแบบแบบกําหนดเอง "d" แสดงวันของเดือนเป็นตัวเลขตั้งแต่ 1 ถึง 31 วันที่มีการจัดรูปแบบตัวเลขเดียวโดยไม่มีเลขศูนย์นําหน้า

หากใช้ตัวระบุรูปแบบ "d" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ ตัวระบุจะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "d" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "d" ในสตริงรูปแบบหลายรายการ

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, M", Culture = ""]),
        // Displays 29, 8 

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "en-US"]),
        // Displays 29, August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "es-MX"])
        // Displays 29, agosto
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "dd"

สตริงรูปแบบแบบกําหนดเอง "dd" แสดงวันของเดือนเป็นตัวเลขตั้งแต่ 01 ถึง 31 วันที่มีตัวเลขเดียวถูกจัดรูปแบบด้วยศูนย์นําหน้า

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "dd" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01 
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "ddd"

ตัวระบุรูปแบบแบบกําหนดเอง "ddd" แสดงชื่อย่อของวันในสัปดาห์ ชื่อย่อที่เป็นภาษาท้องถิ่นของวันของสัปดาห์จะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมที่ระบุ

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "ddd" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
        // Displays Thu 29 Aug

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
        // Displays jeu. 29 août
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "dddd"

ตัวระบุรูปแบบกําหนดเอง "dddd" (บวกตัวระบุ "d" เพิ่มเติมจํานวนใดก็ได้) แสดงถึงชื่อเต็มของวันในสัปดาห์ ชื่อวันในสัปดาห์ที่แปลเป็นภาษาท้องถิ่นจะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมที่ระบุ

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "dddd" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
        // Displays Thursday 29 August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
        // Displays giovedì 29 agosto
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุเศษส่วน "f" วินาทีตัวพิมพ์เล็ก

ตัวระบุรูปแบบที่กําหนดเอง "f"

ตัวระบุรูปแบบที่กําหนดเอง "f" แสดงตัวเลขที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ จะแสดงค่าสิบวินาทีในค่าวันที่และเวลา

ถ้ามีการใช้ตัวระบุรูปแบบ "f" โดยไม่มีตัวระบุรูปแบบอื่น ๆ ตัวระบุรูปแบบจะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "f" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

เมื่อคุณใช้ตัวระบุรูปแบบ "f" เป็นส่วนหนึ่งของสตริงรูปแบบที่ให้มาเพื่อแยกวิเคราะห์จํานวนวินาทีเศษส่วน จํานวนของตัวระบุรูปแบบ "f" จะระบุจํานวนหลักที่สําคัญที่สุดของเศษส่วนวินาทีที่ต้องแสดงเพื่อให้วิเคราะห์สตริงได้สําเร็จ

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "f" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
        // Displays 07:27:15:0

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
        // Displays 07:27:15:
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "ff"

ตัวระบุรูปแบบที่กําหนดเอง "ff" แสดงถึงเลขทศนิยมสองหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ จะแสดงค่าหลายร้อยวินาทีในค่าวันที่และเวลา

ตัวอย่างต่อไปนี้รวมถึงตัวระบุรูปแบบแบบกําหนดเอง "ff" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
        // Displays 07:27:15:01

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
        // Displays 07:27:15:01
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "fff"

ตัวระบุรูปแบบที่กําหนดเอง "fff" แสดงถึงเลขทศนิยมสามหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ แสดงถึงหน่วยมิลลิวินาทีในค่าวันที่และเวลา

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "fff" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
        // Displays 07:27:15:018

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
        // Displays 07:27:15:018
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "ffff"

ตัวระบุรูปแบบที่กําหนดเอง "ffff" แสดงถึงเลขทศนิยมสี่หลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ แสดงถึงหลักหมื่นวินาทีในค่าวันที่และเวลา

แม้ว่าเป็นไปได้ที่จะแสดงค่าสิบพันของคอมโพเนนต์วินาทีของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "fffff"

ตัวระบุรูปแบบที่กําหนดเอง "fffff" แสดงถึงตัวเลขที่มีนัยสําคัญมากที่สุดห้าหลักของเศษส่วนวินาที นั่นคือ แสดงค่าเป็นร้อยพันวินาทีในค่าวันที่และเวลา

แม้ว่าเป็นไปได้ที่จะแสดงคอมโพเนนต์วินาทีเป็นร้อยพันของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "ffffff"

ตัวระบุรูปแบบแบบกําหนดเอง "ffffff" แสดงถึงเลขหกหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ จะแสดงเป็นล้านวินาทีในค่าวันที่และเวลา

แม้ว่าเป็นไปได้ที่จะแสดงคอมโพเนนต์วินาทีนับล้านของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "fffffff"

ตัวระบุรูปแบบแบบกําหนดเอง "fffffff" แสดงถึงเลขเจ็ดหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ แสดงถึงสิบล้านวินาทีในค่าวันที่และเวลา

แม้ว่าเป็นไปได้ที่จะแสดงคอมโพเนนต์วินาทีสิบล้านของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุเศษส่วน "F" วินาทีตัวพิมพ์ใหญ่

ตัวระบุรูปแบบที่กําหนดเอง "F"

ตัวระบุรูปแบบที่กําหนดเอง "F" แสดงตัวเลขที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ จะแสดงค่าสิบวินาทีในค่าวันที่และเวลา ไม่มีการแสดงอะไรถ้าตัวเลขเป็นศูนย์ และจุดทศนิยมที่ตามหลังจํานวนวินาทีจะไม่แสดงขึ้น

หากใช้ตัวระบุรูปแบบ "F" โดยไม่มีตัวระบุรูปแบบอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "F" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

จํานวนตัวระบุรูปแบบ "F" ที่ใช้เมื่อการแยกวิเคราะห์ระบุจํานวนหลักที่สําคัญมากที่สุดของเศษส่วนวินาทีที่สามารถแสดงเพื่อแยกวิเคราะห์สตริงได้สําเร็จ

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "F" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
        // Displays 07:27:15:0

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
        // Displays 07:27:15:
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "FF"

ตัวระบุรูปแบบที่กําหนดเอง "FF" แสดงถึงเลขทศนิยมสองหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ จะแสดงค่าหลายร้อยวินาทีในค่าวันที่และเวลา ไม่มีการแสดงศูนย์ต่อท้าย ไม่มีสิ่งใดแสดงถ้าตัวเลขที่มีนัยสําคัญสองหลักเป็นศูนย์ และในกรณีนี้ จุดทศนิยมที่อยู่หลังจํานวนวินาทีจะไม่แสดงขึ้นด้วย

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "FF" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
        // Displays 07:27:15:01

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
        // Displays 07:27:15:01
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "FFF"

ตัวระบุรูปแบบที่กําหนดเอง "FFF" แสดงถึงเลขทศนิยมสามหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ แสดงถึงหน่วยมิลลิวินาทีในค่าวันที่และเวลา ไม่มีการแสดงศูนย์ต่อท้าย ไม่มีการแสดงอะไรถ้าตัวเลขที่มีนัยสําคัญสามหลักเป็นศูนย์ และในกรณีนี้ จุดทศนิยมที่อยู่หลังจํานวนวินาทีจะไม่แสดงขึ้น

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "FFF" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
        // Displays 07:27:15:018

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
        // Displays 07:27:15:018
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "FFFF"

ตัวระบุรูปแบบแบบกําหนดเอง "FFFF" แสดงถึงเลขหลักที่สําคัญที่สุดสี่หลักของเศษส่วนวินาที นั่นคือ แสดงถึงหลักหมื่นวินาทีในค่าวันที่และเวลา ไม่มีการแสดงศูนย์ต่อท้าย ไม่มีสิ่งใดแสดงถ้าตัวเลขที่มีนัยสําคัญสี่หลักเป็นศูนย์ และในกรณีนี้จุดทศนิยมที่อยู่หลังจํานวนวินาทีจะไม่แสดงขึ้น

แม้ว่าเป็นไปได้ที่จะแสดงค่าสิบพันของคอมโพเนนต์วินาทีของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "FFFFF"

ตัวระบุรูปแบบที่กําหนดเอง "FFFFF" แสดงถึงตัวเลขที่มีนัยสําคัญมากที่สุดห้าหลักของเศษส่วนวินาที นั่นคือ แสดงค่าเป็นร้อยพันวินาทีในค่าวันที่และเวลา ไม่มีการแสดงศูนย์ต่อท้าย ไม่มีสิ่งใดแสดงถ้าตัวเลขที่มีนัยสําคัญห้าหลักเป็นศูนย์ และในกรณีนี้จุดทศนิยมที่อยู่หลังจํานวนวินาทีจะไม่แสดงขึ้น

แม้ว่าเป็นไปได้ที่จะแสดงคอมโพเนนต์วินาทีเป็นร้อยพันของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "FFFFFF"

ตัวระบุรูปแบบที่กําหนดเอง "FFFFFF" แสดงถึงเลขหกหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ จะแสดงเป็นล้านวินาทีในค่าวันที่และเวลา ไม่มีการแสดงศูนย์ต่อท้าย ไม่มีสิ่งใดแสดงถ้าตัวเลขที่มีนัยสําคัญหกหลักเป็นศูนย์ และในกรณีนี้จุดทศนิยมที่อยู่หลังจํานวนวินาทีจะไม่แสดงขึ้น

แม้ว่าเป็นไปได้ที่จะแสดงคอมโพเนนต์วินาทีนับล้านของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "FFFFFFF"

ตัวระบุรูปแบบที่กําหนดเอง "FFFFFFF" แสดงถึงเลขเจ็ดหลักที่สําคัญที่สุดของเศษส่วนวินาที นั่นคือ แสดงถึงสิบล้านวินาทีในค่าวันที่และเวลา ไม่มีการแสดงศูนย์ต่อท้าย ไม่มีสิ่งใดแสดงถ้าตัวเลขที่มีนัยสําคัญเจ็ดหลักเป็นศูนย์ และในกรณีนี้ จุดทศนิยมที่อยู่หลังจํานวนวินาทีจะไม่แสดงขึ้น

แม้ว่าเป็นไปได้ที่จะแสดงคอมโพเนนต์วินาทีสิบล้านของค่าเวลา ค่านั้นอาจไม่สื่อความหมาย ความแม่นยําของค่าวันที่และเวลาขึ้นอยู่กับความละเอียดของนาฬิการะบบ บนระบบปฏิบัติการ Windows Server 2019 และ Windows 11 ความละเอียดของนาฬิกาจะประมาณ 1 มิลลิวินาที

กลับไปที่ตาราง

ตัวระบุรูปแบบ "g" ยุค

ตัวระบุรูปแบบแบบกําหนดเอง "g" หรือ "gg"

ตัวระบุรูปแบบแบบกําหนดเอง "g" หรือ "gg" (บวกตัวระบุ "g" เพิ่มเติมจํานวนเท่าใดก็ได้) แสดงถึงช่วงเวลาหรือยุค เช่น A.D. การดําเนินการจัดรูปแบบจะละเว้นตัวระบุนี้หากวันที่ที่จะจัดรูปแบบไม่มีสตริงช่วงเวลาหรือศักราชที่เกี่ยวข้อง

หากใช้ตัวระบุรูปแบบ "g" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "g" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "g" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = ""]),
        // Displays 08/04/0070 A.D.

        Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = "fr-FR"])
        // Displays 08/04/0070 ap. J.-C.
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบ "h" ของชั่วโมงตัวพิมพ์เล็ก

ตัวระบุรูปแบบที่กําหนดเอง "h"

ตัวระบุรูปแบบที่กําหนดเอง "h" แสดงชั่วโมงเป็นตัวเลขตั้งแต่ 1 ถึง 12 นั่นคือ ชั่วโมงจะแสดงด้วยนาฬิกาแบบ 12 ชั่วโมงที่นับจํานวนชั่วโมงทั้งหมดตั้งแต่เที่ยงคืนหรือเที่ยงวัน หนึ่งชั่วโมงหลังจากเที่ยงคืนนั้นแยกไม่ออกจากชั่วโมงเดียวกันหลังจากเที่ยง ชั่วโมงไม่ได้ถูกปัดเศษและชั่วโมงที่มีตัวเลขเดียวถูกจัดรูปแบบโดยไม่มีศูนย์นําหน้า ตัวอย่างเช่น เมื่อเวลา 5:43 น. ในตอนเช้าหรือบ่าย ตัวระบุรูปแบบแบบกําหนดเองนี้จะแสดง "5"

หากใช้ตัวระบุรูปแบบ "h" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ ตัวระบุจะถูกตีความว่าเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐานและแสดงข้อผิดพลาดของนิพจน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "h" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "hh"

ตัวระบุรูปแบบที่กําหนดเอง "hh" (บวกกับตัวระบุ "h" เพิ่มเติมจํานวนเท่าใดก็ได้) แสดงถึงชั่วโมงเป็นตัวเลขตั้งแต่ 01 ถึง 12 นั่นคือ ชั่วโมงจะแสดงด้วยนาฬิกาแบบ 12 ชั่วโมงที่นับจํานวนชั่วโมงทั้งหมดตั้งแต่เที่ยงคืนหรือเที่ยงวัน หนึ่งชั่วโมงหลังจากเที่ยงคืนนั้นแยกไม่ออกจากชั่วโมงเดียวกันหลังจากเที่ยง ชั่วโมงไม่ได้ถูกปัดเศษขึ้น และชั่วโมงที่มีตัวเลขเดียวถูกจัดรูปแบบด้วยศูนย์นําหน้า ตัวอย่างเช่น เมื่อเวลา 5:43 น. ในตอนเช้าหรือบ่าย ตัวระบุรูปแบบนี้จะแสดง "05"

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "hh" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบ "H" ชั่วโมงตัวพิมพ์ใหญ่

ตัวระบุรูปแบบที่กําหนดเอง "H"

ตัวระบุรูปแบบที่กําหนดเอง "H" แสดงชั่วโมงเป็นตัวเลขตั้งแต่ 0 ถึง 23 นั่นคือ ชั่วโมงจะแสดงด้วยนาฬิกาแบบ 24 ชั่วโมงที่ยึดตามศูนย์ซึ่งนับจํานวนชั่วโมงนับตั้งแต่เที่ยงคืน ชั่วโมงแบบตัวเลขเดียวถูกจัดรูปแบบโดยไม่มีเลขศูนย์นําหน้า

หากใช้ตัวระบุรูปแบบ "H" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ ตัวระบุจะถูกตีความว่าเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐานและแสดงข้อผิดพลาดของนิพจน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "H" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
        // Displays 6:09:01
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "HH"

ตัวระบุรูปแบบที่กําหนดเอง "HH" (บวกกับตัวระบุ "H" เพิ่มเติมจํานวนเท่าใดก็ได้) แสดงถึงชั่วโมงเป็นตัวเลขตั้งแต่ 00 ถึง 23 นั่นคือ ชั่วโมงจะแสดงด้วยนาฬิกาแบบ 24 ชั่วโมงที่ยึดตามศูนย์ซึ่งนับจํานวนชั่วโมงนับตั้งแต่เที่ยงคืน ชั่วโมงแบบตัวเลขเดียวถูกจัดรูปแบบด้วยศูนย์นําหน้า

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "HH" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
        // Displays 06:09:01
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบโซนเวลา "K"

ตัวระบุรูปแบบที่กําหนดเอง "K"

ตัวระบุรูปแบบที่กําหนดเอง "K" แสดงข้อมูลโซนเวลาของค่าวันที่และเวลา เมื่อมีการใช้ตัวระบุรูปแบบนี้กับ ค่า DateTimeZone สตริงผลลัพธ์จะถูกกําหนดเป็น:

• สําหรับโซนเวลาท้องถิ่น ตัวระบุนี้สร้างสตริงผลลัพธ์ที่ประกอบด้วยออฟเซตภายในเครื่องจากเวลามาตรฐานสากล (UTC) ตัวอย่างเช่น "-07:00" ถ้าคิวรีของคุณทํางานใน Power Query Desktop ถ้าคิวรีของคุณทํางานใน Power Query Online สตริงผลลัพธ์จะไม่ก่อให้เกิดออฟเซตจากเวลา UTC นั่นคือ "+00:00"

• สําหรับเวลา UTC สตริงผลลัพธ์จะไม่สร้างออฟเซตจากเวลา UTC ดังนั้น นั่นคือ "+00:00 เพื่อแสดงวันที่ UTC

• สําหรับเวลาจากเขตเวลาที่ไม่ได้ระบุ ผลลัพธ์จะว่างเปล่า

หากใช้ตัวระบุรูปแบบ "K" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ ตัวระบุจะถูกตีความว่าเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐานและแสดงข้อผิดพลาดของนิพจน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้แสดงสตริงที่เป็นผลมาจากการใช้ตัวระบุรูปแบบที่กําหนดเอง "K" ที่มีค่าต่าง ๆ ในระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา

let
    Source =
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(),[Format="%K"]),
        // Displays -07:00 (Desktop) or +00:00 (Online)

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="%K"]),
        // Displays +00:00

        Text.Format("'#{0}'", {DateTime.ToText(DateTime.LocalNow(),[Format="%K"])})
        // Displays ''
    }
in
    Source

หมายเหตุ

ค่าที่ส่งกลับโดย DateTimeZone.LocalNow ขึ้นอยู่กับว่าคุณกําลังใช้งาน Power Query บนเครื่องหรือออนไลน์ ตัวอย่างเช่น ในตัวอย่างข้างต้นบนระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา Power Query Desktop จะส่งกลับ -07:00 มาเนื่องจากกําลังอ่านเวลาที่ตั้งค่าบนเครื่องคอมพิวเตอร์ของคุณ อย่างไรก็ตาม Power Query Online จะ +00:00 ส่งกลับเนื่องจากกําลังอ่านเวลาที่กําหนดบนเครื่องเสมือนบนระบบคลาวด์ซึ่งถูกตั้งค่าเป็น UTC

กลับไปที่ตาราง

ตัวระบุรูปแบบ "m" นาที

ตัวระบุรูปแบบที่กําหนดเอง "m"

ตัวระบุรูปแบบแบบกําหนดเอง "m" แสดงนาทีเป็นตัวเลขตั้งแต่ 0 ถึง 59 นาทีแสดงนาทีทั้งหมดที่ได้รับการส่งผ่านมาตั้งแต่ชั่วโมงที่ผ่านมา นาทีแบบตัวเลขเดียวถูกจัดรูปแบบโดยไม่มีเลขศูนย์นําหน้า

หากใช้ตัวระบุรูปแบบ "m" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "m" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "m" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "mm"

ตัวระบุรูปแบบแบบกําหนดเอง "mm" (บวกกับตัวระบุ "m" เพิ่มเติมจํานวนเท่าใดก็ได้) แสดงนาทีเป็นตัวเลขตั้งแต่ 00 ถึง 59 นาทีแสดงนาทีทั้งหมดที่ได้รับการส่งผ่านมาตั้งแต่ชั่วโมงที่ผ่านมา นาทีแบบตัวเลขเดียวถูกจัดรูปแบบด้วยเลขศูนย์นําหน้า

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "mm" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบเดือน "M"

ตัวระบุรูปแบบแบบกําหนดเอง "M"

ตัวระบุรูปแบบที่กําหนดเอง "M" แสดงเดือนเป็นตัวเลขตั้งแต่ 1 ถึง 12 (หรือจาก 1 ถึง 13 สําหรับปฏิทินที่มี 13 เดือน) เดือนที่มีตัวเลขเดียวถูกจัดรูปแบบโดยไม่มีเลขศูนย์นําหน้า

หากใช้ตัวระบุรูปแบบ "M" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "M" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "M" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "en-US"]),
        // Displays (8) Aug, August

        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "nl-NL"]),
        // Displays (8) aug, augustus

        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "lv-LV"])
        // Displays (8) aug., augusts
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "MM"

ตัวระบุรูปแบบที่กําหนดเอง "MM" แสดงเดือนเป็นตัวเลขตั้งแต่ 01 ถึง 12 (หรือจาก 1 ถึง 13 สําหรับปฏิทินที่มี 13 เดือน) เดือนที่มีตัวเลขเดียวถูกจัดรูปแบบด้วยเลขศูนย์นําหน้า

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "MM" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "MMM"

ตัวระบุรูปแบบที่กําหนดเอง "MMM" แสดงชื่อย่อของเดือน ชื่อย่อที่แปลเป็นภาษาท้องถิ่นของเดือนจะถูกดึงมาจากชื่อเดือนแบบย่อของวัฒนธรรมปัจจุบันหรือวัฒนธรรมที่ระบุ ถ้ามีตัวระบุรูปแบบแบบกําหนดเอง "d" หรือ "dd" ในสตริงรูปแบบแบบกําหนดเอง ชื่อเดือนจะถูกดึงมาจากชื่อทั่วไปที่เป็นตัวย่อแทน

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "MMM" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
        // Displays Thu 29 Aug

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
        // Displays jeu. 29 août
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "MMMM"

ตัวระบุรูปแบบที่กําหนดเอง "MMMM" แสดงชื่อเต็มของเดือน ชื่อเดือนที่แปลเป็นภาษาท้องถิ่นจะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมที่ระบุ ถ้ามีตัวระบุรูปแบบแบบกําหนดเอง "d" หรือ "dd" ในสตริงรูปแบบแบบกําหนดเอง ชื่อเดือนจะถูกดึงมาจากชื่อทั่วไปที่เป็นตัวย่อแทน

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "MMMM" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
        // Displays Thursday 29 August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
        // Displays giovedì 29 agosto
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบ "s" วินาที

ตัวระบุรูปแบบแบบกําหนดเอง "s"

ตัวระบุรูปแบบแบบกําหนดเอง "s" แสดงวินาทีเป็นตัวเลขตั้งแต่ 0 ถึง 59 ผลลัพธ์แสดงวินาทีทั้งหมดที่ส่งผ่านมาตั้งแต่นาทีสุดท้าย วินาทีที่มีตัวเลขเดียวถูกจัดรูปแบบโดยไม่มีเลขศูนย์นําหน้า

หากใช้ตัวระบุรูปแบบ "s" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "s" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "s" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "ss"

ตัวระบุรูปแบบแบบกําหนดเอง "ss" (บวกกับตัวระบุ "s" เพิ่มเติมจํานวนเท่าใดก็ได้) แสดงวินาทีเป็นตัวเลขตั้งแต่ 00 ถึง 59 ผลลัพธ์แสดงวินาทีทั้งหมดที่ส่งผ่านมาตั้งแต่นาทีสุดท้าย วินาทีที่เป็นตัวเลขเดียวถูกจัดรูปแบบด้วยเลขศูนย์นําหน้า

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "ss" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบ "t" Meridiem

ตัวระบุรูปแบบที่กําหนดเอง "t"

ตัวระบุรูปแบบแบบกําหนดเอง "t" แสดงอักขระตัวแรกของตัวออกแบบ AM/PM ผู้ออกแบบที่แปลเป็นภาษาท้องถิ่นที่เหมาะสมจะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมเฉพาะ ตัวกําหนด AM ใช้สําหรับเวลาทั้งหมดตั้งแต่ 0:00:00 (เที่ยงคืน) ถึง 11:59:59.999 ตัวกําหนด PM จะใช้สําหรับทุกเวลาตั้งแต่ 12:00:00 (เที่ยง) ถึง 23:59:59.999

หากใช้ตัวระบุรูปแบบ "t" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "t" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "t" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบที่กําหนดเอง "tt"

ตัวระบุรูปแบบกําหนดเอง "tt" (บวกกับตัวระบุ "t" เพิ่มเติมจํานวนใดก็ได้) แสดงถึงตัวออกแบบ AM/PM ทั้งหมด ผู้ออกแบบที่แปลเป็นภาษาท้องถิ่นที่เหมาะสมจะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมเฉพาะ ตัวกําหนด AM ใช้สําหรับเวลาทั้งหมดตั้งแต่ 0:00:00 (เที่ยงคืน) ถึง 11:59:59.999 ตัวกําหนด PM จะใช้สําหรับทุกเวลาตั้งแต่ 12:00:00 (เที่ยง) ถึง 23:59:59.999

ตรวจสอบให้แน่ใจว่าได้ใช้ตัวระบุ "tt" สําหรับภาษาที่จําเป็นในการรักษาความแตกต่างระหว่าง AM และ PM ตัวอย่างคือภาษาญี่ปุ่นซึ่งตัวกําหนด AM และ PM แตกต่างกันในอักขระตัวที่สองแทนอักขระตัวแรก

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "tt" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบ "y" ปี

ตัวระบุรูปแบบที่กําหนดเอง "y"

ตัวระบุรูปแบบที่กําหนดเอง "y" แสดงปีเป็นตัวเลขหนึ่งหลักหรือสองหลัก ถ้าปีมีตัวเลขมากกว่าสองหลัก เฉพาะตัวเลขลําดับต่ําสองหลักเท่านั้นที่จะปรากฏในผลลัพธ์ ถ้าตัวเลขแรกของปีที่มีสองหลักเริ่มต้นด้วยศูนย์ (ตัวอย่างเช่น 2008) ตัวเลขจะถูกจัดรูปแบบโดยไม่มีศูนย์นําหน้า

หากใช้ตัวระบุรูปแบบ "y" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐาน "y" สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "y" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "%y"]),
        // Displays 1

        Date.ToText(#date(2024, 1, 1), [Format = "%y"])
        // Displays 24
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "yyy"

ตัวระบุรูปแบบที่กําหนดเอง "yyy" แสดงปีเป็นตัวเลขสองหลัก ถ้าปีมีตัวเลขมากกว่าสองหลัก เฉพาะตัวเลขลําดับต่ําสองหลักเท่านั้นที่จะปรากฏในผลลัพธ์ ถ้าปีที่มีตัวเลขสองหลักมีจํานวนหลักนัยสําคัญน้อยกว่าสองหลัก ตัวเลขจะถูกเติมช่องว่างภายในด้วยเลขศูนย์นําหน้าเพื่อสร้างตัวเลขสองหลัก

ในการดําเนินการแยกวิเคราะห์ ปีที่มีสองหลักที่แยกวิเคราะห์โดยใช้ตัวระบุรูปแบบที่กําหนดเอง "yy" จะถูกแปลโดยยึดตามปฏิทินปัจจุบันของผู้ให้บริการรูปแบบ ตัวอย่างต่อไปนี้แยกวิเคราะห์สตริงของวันที่ที่มีปีที่มีสองหลักโดยใช้ปฏิทินเกรกอเรียนเริ่มต้นของวัฒนธรรม en-US ซึ่งในกรณีนี้คือวัฒนธรรมปัจจุบัน ค่าที่แสดงสําหรับวันที่แบบสี่หลักจะขึ้นอยู่กับช่วง 100 ปีที่กําหนดโดยระบบปฏิบัติการ

let
    // Define the date format and value
    fmt = "dd-MMM-yy",

    // Convert year 49 to a 4-digit year
    firstDate = Text.Format("#{0}", { Date.FromText("24-Jan-49", [Format = fmt]) }),

    // Convert year 50 to a 4-digit year
    finalDate = Text.Format("#{0}", { Date.FromText("24-Jan-50", [Format = fmt]) }),
    Heading = "Default Two Digit Year Range: 1950 - 2049",
    result = {Heading, firstDate, finalDate}
in
    result

// The example displays the following output:
//       Default Two Digit Year Range: 1950 - 2049
//       1/24/2049
//       1/24/1950

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "yyy" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yy"]),
        // Displays 01

        Date.ToText(#date(2024, 1, 1), [Format = "yy"])
        // Displays 24
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "yyyy"

ตัวระบุรูปแบบกําหนดเอง "yyyy" แสดงปีที่มีตัวเลขอย่างน้อยสามหลัก ถ้าปีมีตัวเลขนัยสําคัญมากกว่าสามหลัก ตัวเลขดังกล่าวจะรวมอยู่ในสตริงผลลัพธ์ ถ้าปีมีจํานวนหลักน้อยกว่าสามหลัก ตัวเลขจะถูกเติมช่องว่างภายในด้วยเลขศูนย์นําหน้าเพื่อสร้างตัวเลขสามหลัก

หมายเหตุ

สําหรับปฏิทินพุทธไทยซึ่งอาจมีปีห้าหลัก ตัวระบุรูปแบบนี้จะแสดงตัวเลขที่สําคัญทั้งหมด

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบที่กําหนดเอง "yyy" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
        // Displays 001

        Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
        // Displays 2024
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "yyyy"

ตัวระบุรูปแบบกําหนดเอง "yyyy" แสดงปีที่มีตัวเลขอย่างน้อยสี่หลัก ถ้าปีมีตัวเลขนัยสําคัญมากกว่าสี่หลัก ตัวเลขดังกล่าวจะรวมอยู่ในสตริงผลลัพธ์ ถ้าปีมีจํานวนหลักน้อยกว่าสี่หลัก ตัวเลขจะถูกเติมช่องว่างภายในด้วยเลขศูนย์นําหน้าเพื่อสร้างตัวเลขสี่หลัก

หมายเหตุ

ตัวระบุรูปแบบนี้จะแสดงตัวเลขอย่างน้อยสี่หลัก สําหรับปฏิทินพุทธศาสนาไทยซึ่งอาจมีปีห้าหลัก

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบแบบกําหนดเอง "yyyy" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
        // Displays 0001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
        // Displays 2024
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "yyyyy"

ตัวระบุรูปแบบกําหนดเอง "yyyyy" (บวกตัวระบุ "y" เพิ่มเติมจํานวนเท่าใดก็ได้) แสดงปีที่มีตัวเลขอย่างน้อยห้าหลัก ถ้าปีมีตัวเลขนัยสําคัญมากกว่าห้าหลัก ตัวเลขดังกล่าวจะรวมอยู่ในสตริงผลลัพธ์ ถ้าปีมีจํานวนหลักน้อยกว่าห้าหลัก ตัวเลขจะถูกเติมช่องว่างภายในด้วยเลขศูนย์นําหน้าเพื่อสร้างตัวเลขห้าหลัก

ถ้ามีตัวระบุ "y" เพิ่มเติมอยู่ข้างใน ตัวเลขจะถูกเติมช่องว่างภายในด้วยเลขศูนย์นําหน้ามากเท่าที่จําเป็นในการสร้างตัวระบุ "y"

ตัวอย่างต่อไปนี้ประกอบด้วยตัวระบุรูปแบบที่กําหนดเอง "yyyyy" ในสตริงรูปแบบแบบกําหนดเอง

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
        // Displays 00001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
        // Displays 02024
    }
in
    Source

กลับไปที่ตาราง

ตัวระบุรูปแบบ "z" ออฟเซต

ตัวระบุรูปแบบที่กําหนดเอง "z"

ด้วย ค่าของโซน วันที่เวลา ตัวระบุรูปแบบที่กําหนดเอง "z" แสดงออฟเซตที่มีเครื่องหมายของโซนเวลาที่ระบุจากเวลามาตรฐานสากล (UTC) ซึ่งวัดเป็นชั่วโมง ออฟเซตจะแสดงด้วยเครื่องหมายนําหน้าเสมอ เครื่องหมายบวก (+) ระบุชั่วโมงก่อน UTC และเครื่องหมายลบ (-) แสดงชั่วโมงที่อยู่หลัง UTC ออฟเซตตัวเลขเดียวถูกจัดรูปแบบ โดยไม่มี เลขศูนย์นําหน้า

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงของค่าออฟเซตโดยขึ้นอยู่กับฟังก์ชัน DateTimeZone

ค่าโซนวันที่เวลา	ค่าออฟเซต
DateTimeZone.LocalNow	บน Power Query Desktop ออฟเซตที่มีเครื่องหมายของโซนเวลาของระบบปฏิบัติการเฉพาะที่จาก UTC บน Power Query Online ให้ส่งกลับ+00
DateTimeZone.UtcNow	ส่งกลับ+0

หากใช้ตัวระบุรูปแบบ "z" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ ตัวระบุจะถูกตีความว่าเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐานและแสดงข้อผิดพลาดของนิพจน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

ตัวอย่างต่อไปนี้รวมถึงตัวระบุรูปแบบแบบกําหนดเอง "z" ในสตริงรูปแบบแบบกําหนดเองบนระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:%z}"]),
        // Displays {0:-7} on Power Query Desktop
        // Displays {0:+0} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:%z}"]),
        // Displays {0:+0}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:%z}"]
        )
        // Displays {0:+6}
    }
in
    Source

หมายเหตุ

ค่าที่ส่งกลับโดย DateTimeZone.LocalNow ขึ้นอยู่กับว่าคุณกําลังใช้งาน Power Query บนเครื่องหรือออนไลน์ ตัวอย่างเช่น ในตัวอย่างข้างต้นบนระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา Power Query Desktop จะส่งกลับ {0:-7} มาเนื่องจากกําลังอ่านเวลาที่ตั้งค่าบนเครื่องคอมพิวเตอร์ของคุณ อย่างไรก็ตาม Power Query Online จะ {0:+0} ส่งกลับเนื่องจากกําลังอ่านเวลาที่กําหนดบนเครื่องเสมือนบนระบบคลาวด์ซึ่งถูกตั้งค่าเป็น UTC

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "zz"

ด้วย ค่า DateTimeZone ตัวระบุรูปแบบที่กําหนดเอง "zz" จะแสดงออฟเซตที่มีเครื่องหมายของโซนเวลาที่ระบุจาก UTC ซึ่งวัดเป็นชั่วโมง ออฟเซตจะแสดงด้วยเครื่องหมายนําหน้าเสมอ เครื่องหมายบวก (+) ระบุชั่วโมงก่อน UTC และเครื่องหมายลบ (-) แสดงชั่วโมงที่อยู่หลัง UTC ออฟเซตตัวเลขเดียวถูกจัดรูปแบบ ด้วย ศูนย์นําหน้า

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงของค่าออฟเซตโดยขึ้นอยู่กับฟังก์ชัน DateTimeZone

ค่าโซนวันที่เวลา	ค่าออฟเซต
DateTimeZone.LocalNow	บน Power Query Desktop ออฟเซตที่มีเครื่องหมายของโซนเวลาของระบบปฏิบัติการเฉพาะที่จาก UTC บน Power Query Online ให้ส่งกลับ+00
DateTimeZone.UtcNow	ส่งกลับ+00

ตัวอย่างต่อไปนี้รวมถึงตัวระบุรูปแบบแบบกําหนดเอง "zz" ในสตริงรูปแบบแบบกําหนดเองบนระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zz}"]),
        // Displays {0:-07} on Power Query Desktop
        // Displays {0:+00} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zz}"]),
        // Displays {0:+00}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:zz}"]
        )
        // Displays {0:+06}
    }
in
    Source

หมายเหตุ

ค่าที่ส่งกลับโดย DateTimeZone.LocalNow ขึ้นอยู่กับว่าคุณกําลังใช้งาน Power Query บนเครื่องหรือออนไลน์ ตัวอย่างเช่น ในตัวอย่างข้างต้นบนระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา Power Query Desktop จะส่งกลับ {0:-07} มาเนื่องจากกําลังอ่านเวลาที่ตั้งค่าบนเครื่องคอมพิวเตอร์ของคุณ อย่างไรก็ตาม Power Query Online จะ {0:+00} ส่งกลับเนื่องจากกําลังอ่านเวลาที่กําหนดบนเครื่องเสมือนบนระบบคลาวด์ซึ่งถูกตั้งค่าเป็น UTC

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "zzz"

ด้วย ค่า DateTimeZone ตัวระบุรูปแบบที่กําหนดเอง "zzz" แสดงออฟเซตที่มีเครื่องหมายของโซนเวลาที่ระบุจาก UTC ซึ่งวัดเป็นชั่วโมงและนาที ออฟเซตจะแสดงด้วยเครื่องหมายนําหน้าเสมอ เครื่องหมายบวก (+) ระบุชั่วโมงก่อน UTC และเครื่องหมายลบ (-) แสดงชั่วโมงที่อยู่หลัง UTC ออฟเซตตัวเลขเดียวถูกจัดรูปแบบด้วยศูนย์นําหน้า

ตารางต่อไปนี้แสดงการเปลี่ยนแปลงของค่าออฟเซตโดยขึ้นอยู่กับฟังก์ชัน DateTimeZone

ค่า DateTimeZoneValue	ค่าออฟเซต
DateTimeZone.LocalNow	บน Power Query Desktop ออฟเซตที่มีเครื่องหมายของโซนเวลาของระบบปฏิบัติการเฉพาะที่จาก UTC บน Power Query Online ให้ส่งกลับ+00
DateTimeZone.UtcNow	ส่งกลับ+00:00

ตัวอย่างต่อไปนี้รวมถึงตัวระบุรูปแบบแบบกําหนดเอง "zzz" ในสตริงรูปแบบแบบกําหนดเองในระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zzz}"]),
        // Displays {0:-07:00} on Power Query Desktop
        // Displays {0:+00:00} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zzz}"]),
        // Displays {0:+00:00}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:zzz}"]
        )
        // Displays {0:+06:00}
    }
in
    Source

หมายเหตุ

ค่าที่ส่งกลับโดย DateTimeZone.LocalNow ขึ้นอยู่กับว่าคุณกําลังใช้งาน Power Query บนเครื่องหรือออนไลน์ ตัวอย่างเช่น ในตัวอย่างข้างต้นบนระบบในโซนเวลาแปซิฟิกของสหรัฐอเมริกา Power Query Desktop จะส่งกลับ {0:-07:00} มาเนื่องจากกําลังอ่านเวลาที่ตั้งค่าบนเครื่องคอมพิวเตอร์ของคุณ อย่างไรก็ตาม Power Query Online จะ {0:+00:00} ส่งกลับเนื่องจากกําลังอ่านเวลาที่กําหนดบนเครื่องเสมือนบนระบบคลาวด์ซึ่งถูกตั้งค่าเป็น UTC

กลับไปที่ตาราง

ตัวระบุตัวคั่นวันที่และเวลา

ตัวระบุรูปแบบที่กําหนดเอง ":"

ตัวระบุรูปแบบแบบกําหนดเอง ":" แสดงตัวคั่นเวลา ซึ่งใช้ในการแยกชั่วโมง นาที และวินาที ตัวคั่นเวลาเฉพาะที่เหมาะสมจะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมที่ระบุ

หมายเหตุ

หากต้องการเปลี่ยนตัวคั่นเวลาสําหรับสตริงวันที่และเวลาเฉพาะ ให้ระบุอักขระตัวคั่นภายในตัวคั่นสตริงสัญพจน์ ตัวอย่างเช่น สตริง hh_dd_ss รูปแบบแบบกําหนดเองจะสร้างสตริงผลลัพธ์ซึ่ง "_" (ขีดล่าง) จะถูกใช้เป็นตัวคั่นเวลาเสมอ

หากใช้ตัวระบุรูปแบบ ":" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ จะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐานและแสดงข้อผิดพลาดของนิพจน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

กลับไปที่ตาราง

ตัวระบุรูปแบบแบบกําหนดเอง "/"

ตัวระบุรูปแบบแบบกําหนดเอง "/" แสดงถึงตัวคั่นวันที่ ซึ่งใช้ในการแยกปี เดือน และวัน ตัวคั่นวันที่ที่แปลเป็นภาษาท้องถิ่นที่เหมาะสมจะถูกดึงมาจากวัฒนธรรมปัจจุบันหรือวัฒนธรรมที่ระบุ

หมายเหตุ

หากต้องการเปลี่ยนตัวคั่นวันที่สําหรับสตริงวันที่และเวลาเฉพาะ ให้ระบุอักขระตัวคั่นภายในตัวคั่นสตริงสัญพจน์ ตัวอย่างเช่น สตริง mm/dd/yyyy รูปแบบแบบกําหนดเองจะสร้างสตริงผลลัพธ์ที่ใช้ "/" เป็นตัวคั่นวันที่เสมอ

หากใช้ตัวระบุรูปแบบ "/" โดยไม่มีตัวระบุรูปแบบแบบกําหนดเองอื่น ๆ ตัวระบุจะถูกแปลเป็นตัวระบุรูปแบบวันที่และเวลามาตรฐานและแสดงข้อผิดพลาดของนิพจน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ตัวระบุรูปแบบเดียว ให้ไปที่ การใช้ตัว ระบุรูปแบบแบบกําหนดเองตัวเดียว ภายหลังในบทความนี้

กลับไปที่ตาราง

สัญพจน์อักขระ

อักขระต่อไปนี้ในสตริงรูปแบบวันที่และเวลาแบบกําหนดเองจะถูกสงวนไว้ และจะถูกแปลเป็นอักขระการจัดรูปแบบเสมอ หรือในกรณีของ "', /, และ \เป็นอักขระพิเศษ

• F
• H
• K
• M
• d
• f
• g
• h
• m
• s
• t
• y
• z
• %
• :
• /
• "
• '
• \

อักขระอื่น ๆ ทั้งหมดจะถูกตีความว่าเป็นสัญพจน์ของอักขระเสมอ และในการดําเนินการจัดรูปแบบจะรวมอยู่ในสตริงผลลัพธ์ที่ไม่เปลี่ยนแปลง ในการดําเนินการแยกวิเคราะห์ การดําเนินการดังกล่าวจะต้องตรงกับอักขระในสตริงที่ป้อนเข้าอย่างถูกต้อง การเปรียบเทียบต้องตรงตามตัวพิมพ์ใหญ่-เล็ก

ตัวอย่างต่อไปนี้รวมถึงอักขระสัญพจน์ "PST" (สําหรับเวลามาตรฐานแปซิฟิก) และ "PDT" (สําหรับเวลาตามฤดูกาลแปซิฟิก) เพื่อแสดงโซนเวลาท้องถิ่นในสตริงรูปแบบ โปรดทราบว่าสตริงจะรวมอยู่ในสตริงผลลัพธ์ และสตริงที่มีสตริงโซนเวลาท้องถิ่นยังแยกวิเคราะห์ได้สําเร็จ

let
    #"Date Formats" = {"dd MMM yyyy hh:mm tt PST", "dd MMM yyyy hh:mm tt PDT"},
    Source = 
    {
        DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Formats"{1}]),
        try DateTime.ToText(DateTime.FromText(
            "25 Dec 2023 12:00 pm PST", [Format = #"Date Formats"{0}])) 
            otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm PST" & "'"
    }
in
    Source

// The example displays the following output text:
//       18 Aug 2024 04:50 PM PDT
//       12/25/2023 12:00:00 PM

มีสองวิธีในการระบุว่าอักขระจะถูกแปลเป็นอักขระสัญพจน์และไม่เป็นอักขระสํารองเพื่อให้สามารถรวมอยู่ในสตริงผลลัพธ์หรือแยกวิเคราะห์ในสตริงอินพุตได้สําเร็จ:

• โดยการละทิ้งอักขระที่สงวนไว้แต่ละตัว สําหรับข้อมูลเพิ่มเติม ให้ไปที่ การใช้ลําดับการหลีกเลี่ยง

  ตัวอย่างต่อไปนี้รวมถึงอักขระสัญพจน์ "pst" (สําหรับเวลามาตรฐานแปซิฟิก) เพื่อแสดงโซนเวลาท้องถิ่นในสตริงรูปแบบ เนื่องจากทั้ง "s" และ "t" เป็นสตริงรูปแบบแบบกําหนดเอง จึงต้องหลีกตัวอักขระทั้งสองให้ถูกแปลเป็นสัญพจน์ของอักขระ

  let
        #"Date Format" = "dd MMM yyyy hh:mm tt p's''t'",
        Source = 
        {
            DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]),
            try DateTime.ToText(DateTime.FromText(
                "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"]))
                otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'"
        }
  in
        Source
  
  // The example displays the following output text:
  //       18 Aug 2024 04:50 PM pst
  //       12/25/2016 12:00:00 PM
  

• โดยการใส่สตริงสัญพจน์ทั้งหมดในเครื่องหมายอัญประกาศ ตัวอย่างต่อไปนี้จะเหมือนกับรายการก่อนหน้า ยกเว้นว่า "pst" อยู่ในเครื่องหมายบุพบทเพื่อระบุว่าสตริงที่มีตัวคั่นทั้งหมดควรได้รับการแปลเป็นสัญพจน์ของอักขระ

  let
        #"Date Format" = "dd MMM yyyy hh:mm tt 'pst'",
        Source = 
        {
            DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]),
            try DateTime.ToText(DateTime.FromText(
                "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"]))
                otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'"
        }
  in
        Source
  
  // The example displays the following output text:
  //       18 Aug 2024 04:50 PM pst
  //       12/25/2016 12:00:00 PM
  

บันทึกย่อ

การใช้ตัวระบุรูปแบบกําหนดเองตัวเดียว

สตริงรูปแบบวันที่และเวลาแบบกําหนดเองประกอบด้วยอักขระสองตัวหรือมากกว่า วิธีการจัดรูปแบบวันที่และเวลาตีความสตริงอักขระเดี่ยวใด ๆ เป็นสตริงรูปแบบวันที่และเวลามาตรฐาน หากไม่รู้จักอักขระเป็นตัวระบุรูปแบบที่ถูกต้อง จะแสดงข้อผิดพลาดของนิพจน์ ตัวอย่างเช่น สตริงรูปแบบที่ประกอบด้วยเฉพาะตัวระบุ "h" จะถูกแปลเป็นสตริงรูปแบบวันที่และเวลามาตรฐาน อย่างไรก็ตาม ในกรณีนี้ ข้อยกเว้นจะเกิดขึ้นเนื่องจากไม่มีตัวระบุรูปแบบวันที่และเวลามาตรฐาน "h"

หากต้องการใช้ตัวระบุรูปแบบวันที่และเวลาแบบกําหนดเองใด ๆ เป็นตัวระบุเดียวในสตริงรูปแบบ (นั่นคือ เพื่อใช้ตัวระบุรูปแบบ "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", หรือ "/" custom format เอง) รวมช่องว่างก่อนหรือหลังตัวระบุ หรือรวมตัวระบุเปอร์เซ็นต์ ("%") ก่อนตัวระบุวันที่และเวลาแบบกําหนดเองตัวเดียว

ตัวอย่างเช่น "%h" จะถูกตีความว่าเป็นสตริงรูปแบบวันที่และเวลาที่กําหนดเองที่แสดงชั่วโมงที่แสดงโดยค่าวันที่และเวลาปัจจุบัน คุณยังสามารถใช้สตริงรูปแบบ "h" หรือ "h" แม้ว่าจะรวมช่องว่างในสตริงผลลัพธ์พร้อมกับชั่วโมง ตัวอย่างต่อไปนี้แสดงสตริงรูปแบบสามรายการเหล่านี้

let
    date = #datetime(2024, 6, 15, 13, 45, 0),
    Source =
    {
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "%h"])}),
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = " h"])}),
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "h "])})
    }
in
    Source

// The example displays a list with the following output text, 
//   with <sp> representing a space:
//       '1'
//       ' 1'
//       '1 ' 

การใช้ลําดับการหลีก

อักขระ "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", หรือ "/" ในสตริงรูปแบบจะถูกแปลเป็นตัวระบุรูปแบบแบบกําหนดเองแทนที่จะเป็นอักขระสัญพจน์

หากต้องการป้องกันไม่ให้มีการแปลอักขระเป็นตัวระบุรูปแบบ คุณสามารถ:

• นําหน้าด้วยเครื่องหมายทับขวา
• ล้อมรอบด้วยอัญประกาศเดี่ยว
• ล้อมรอบด้วยเครื่องหมายอัญประกาศสองอัน

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

เมื่อต้องการรวมเครื่องหมายอัญประกาศคู่ในสตริงผลลัพธ์ คุณต้องหลีกเลี่ยงด้วยเครื่องหมายอัญประกาศคู่อีกอัน ("")

ตัวอย่างต่อไปนี้ใช้ลําดับการหลีกเลี่ยงที่แตกต่างกันเพื่อป้องกันการดําเนินการจัดรูปแบบจากการแปลอักขระ "h" และ "m" เป็นตัวระบุรูปแบบ

let
    date = #datetime(2024, 6, 15, 13, 45, 30.90),
    format1 = "h \h m \m",
    format2 = "h ""h"" m ""m""",
    format3 = "h 'h' m 'm'",
    Source = 
    {
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format1, DateTime.ToText(date, format1)}),
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format2, DateTime.ToText(date, format2)}),
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format3, DateTime.ToText(date, format3)})
    }
in
    Source

// The example displays the following output text:
//       6/15/2024 1:45:30 PM (h \h m \m) -> 1 h 45 m
//       6/15/2024 1:45:30 PM (h "h" m "m") -> 1 h 45 m
//       6/15/2024 1:45:30 PM (h 'h' m 'm') -> 1 h 45 m

เนื้อหาที่เกี่ยวข้อง

• วัฒนธรรมมีผลต่อการจัดรูปแบบข้อความอย่างไร
• การแปลงประเภทวันที่ เวลา วันที่เวลา และวันที่เขตเวลา
• ฟังก์ชันวันที่
• ฟังก์ชัน DateTime
• ฟังก์ชัน DateTimeZone
• ฟังก์ชันเวลา
• สตริงรูปแบบวันที่และเวลามาตรฐาน