แชร์ผ่าน


สตริงรูปแบบตัวเลขมาตรฐาน

สตริงรูปแบบตัวเลขมาตรฐานถูกใช้เพื่อจัดรูปแบบชนิดตัวเลขทั่วไป สตริงรูปแบบตัวเลขมาตรฐานจะอยู่ในรูปแบบ [format specifier][precision specifier]ที่ซึ่ง:

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

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

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

    หมายเหตุ

    ตัวระบุความแม่นยําจะกําหนดจํานวนหลักในสตริงผลลัพธ์ เมื่อต้องการเติมช่องว่างนําหน้าหรือต่อท้ายหรืออักขระอื่น ๆ (เช่น 0) ให้ใช้ฟังก์ชัน Text.PadStart และ Text.PadEnd และใช้ความยาวโดยรวม count ในฟังก์ชันเหล่านี้เพื่อเพิ่มสตริงผลลัพธ์

สตริงรูปแบบตัวเลขมาตรฐานได้รับการสนับสนุนโดยฟังก์ชัน Number.ToText

ตัวระบุรูปแบบมาตรฐาน

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

หมายเหตุ

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

ตัวระบุรูปแบบ ชื่อ รายละเอียด ตัวอย่าง
"C" หรือ "c" สกุลเงิน ผลลัพธ์: ค่าสกุลเงิน

ได้รับการสนับสนุนโดย: ชนิดตัวเลขทั้งหมด

ตัวระบุความแม่นยํา: จํานวนทศนิยม

ตัวระบุความแม่นยําเริ่มต้น: กําหนดโดยวัฒนธรรม

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบสกุลเงิน ("C")
123.456 ("C", en-US)
-> \$123.46

123.456 ("C", fr-FR)
-> 123,46 €

123.456 ("C", ja-JP)
-> ¥123

-123.456 ("C3", en-US)
-> (\$123.456)

-123.456 ("C3", fr-FR)
-> -123,456 €

-123.456 ("C3", ja-JP)
-> -¥123.456
"D" หรือ "d" Decimal ผลลัพธ์: จํานวนเต็มที่มีเครื่องหมายลบที่เลือกได้

ได้รับการสนับสนุนโดย: ชนิดจํานวนเต็มเท่านั้น

ตัวระบุความแม่นยํา: จํานวนขั้นต่ําของตัวเลข

ตัวระบุความแม่นยําเริ่มต้น: จํานวนขั้นต่ําของตัวเลขที่จําเป็น

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบ Decimal("D")
1234 ("D")
-> 1234

-1234 ("D6")
-> 001234
หรือ เอ็กซ์โพเนนเชียล (วิทยาศาสตร์) ผลลัพธ์: สถาปนิกเอ็กซ์โพเนนเชียล

ได้รับการสนับสนุนโดย: ชนิดตัวเลขทั้งหมด

ตัวระบุความแม่นยํา: จํานวนทศนิยม

ตัวระบุความแม่นยําเริ่มต้น: 6

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบเอ็กซ์โพเนนเชียล
1052.0329112756, en-US)
-> 1.052033E+003

1052.0329112756, fr-FR)
-> 1,052033e+003

-1052.0329112756 ("e2", en-US)
-> -1.05e+003

-1052.0329112756 ("E2", fr-FR)
-> -1,05E+003
"F" หรือ "f" จุดทศนิยมตายตัว ผลลัพธ์: จํานวนเต็มและทศนิยมที่มีเครื่องหมายลบที่เป็นทางเลือก

ได้รับการสนับสนุนโดย: ชนิดตัวเลขทั้งหมด

ตัวระบุความแม่นยํา: จํานวนทศนิยม

ตัวระบุความแม่นยําเริ่มต้น: กําหนดโดยวัฒนธรรม

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบจุดทศนิยมตายตัว ("F")
1234.567 ("F", en-US)
-> 1234.57

1234.567 ("F", de-DE)
-> 1234,57

1234 ("F1", en-US)
-> 1234.0

1234 ("F1", de-DE)
-> 1234,0

-1234.56 ("F4", en-US)
-> -1234.5600

-1234.56 ("F4", de-DE)
-> -1234,5600
"G" หรือ "g" ทั่วไป ผลลัพธ์: ยิ่งมีจุดทศนิยมคงที่หรือทางวิทยาศาสตร์มากเท่าไหร่

ได้รับการสนับสนุนโดย: ชนิดตัวเลขทั้งหมด

ตัวระบุความแม่นยํา: จํานวนหลักที่มีนัยสําคัญ

ตัวระบุความแม่นยําเริ่มต้น: ขึ้นอยู่กับชนิดตัวเลข

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบทั่วไป ("G")
-123.456 ("G", en-US)
-> -123.456

-123.456 ("G", sv-SE)
-> -123,456

123.4546 ("G4", en-US)
-> 123.5

123.4546 ("G4", sv-SE)
-> 123,5

-1.234567890e-25 ("G", en-US)
-> -1.23456789E-25

-1.234567890e-25 ("G", sv-SE)
-> -1,23456789E-25
"N" หรือ "n" หมายเลข ผลลัพธ์: จํานวนเต็มและทศนิยม ตัวคั่นกลุ่ม และตัวคั่นทศนิยมที่มีเครื่องหมายลบทางเลือก

ได้รับการสนับสนุนโดย: ชนิดตัวเลขทั้งหมด

ตัวระบุความแม่นยํา: จํานวนตําแหน่งทศนิยมที่ต้องการ

ตัวระบุความแม่นยําเริ่มต้น: กําหนดโดยวัฒนธรรม

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบตัวเลข ("N")
1234.567 ("N", en-US)
-> 1,234.57

1234.567 ("N", ru-RU)
-> 1 234,57

1234 ("N1", en-US)
-> 1,234.0

1234 ("N1", ru-RU)
-> 1 234,0

-1234.56 ("N3", en-US)
-> -1,234.560

-1234.56 ("N3", ru-RU)
-> -1 234,560
"P" หรือ "p" เปอร์เซ็นต์ ผลลัพธ์: จํานวนที่คูณด้วย 100 และแสดงด้วยสัญลักษณ์เปอร์เซ็นต์

ได้รับการสนับสนุนโดย: ชนิดตัวเลขทั้งหมด

ตัวระบุความแม่นยํา: จํานวนตําแหน่งทศนิยมที่ต้องการ

ตัวระบุความแม่นยําเริ่มต้น: กําหนดโดยวัฒนธรรม

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบเปอร์เซ็นต์ ("P")
1 ("P", en-US)
-> 100.00 %

1 ("P", fr-FR)
-> 100,00 %

-0.39678 ("P1", en-US)
-> -39.7 %

-0.39678 ("P1", fr-FR)
-> -39,7 %
"X" หรือ "x" ฐานสิบหก ผลลัพธ์: สตริงเลขฐานสิบหก

ได้รับการสนับสนุนโดย: ชนิดจํานวนเต็มเท่านั้น

ตัวระบุความแม่นยํา: จํานวนหลักในสตริงผลลัพธ์

ข้อมูลเพิ่มเติม: ตัวระบุรูปแบบฐานสิบหก ("X")
255 ("X")
-> FF

-1 ("x")
-> อฟฟ์

255 ("x4")
-> 00 ฟฟ์

-1 ("X4")
-> 00FF
อักขระเดี่ยวอื่นๆ ตัวระบุที่ไม่รู้จัก ผลลัพธ์: แสดงข้อผิดพลาดของนิพจน์ในเวลาที่เรียกใช้งาน

ใช้สตริงรูปแบบตัวเลขมาตรฐาน

สตริงรูปแบบตัวเลขมาตรฐานสามารถใช้เพื่อกําหนดการจัดรูปแบบของค่าตัวเลข ซึ่งสามารถส่งผ่านไปยังพารามิเตอร์ Number.ToTextformat ได้ ตัวอย่างต่อไปนี้จัดรูปแบบค่าตัวเลขเป็นสตริงสกุลเงินในวัฒนธรรมปัจจุบัน (ในกรณีนี้คือวัฒนธรรม en-US)

Number.ToText(123.456, "C2")
// Displays $123.46

อีกทางหนึ่งคือ คุณสามารถใส่อาร์กิวเมนต์ count ในฟังก์ชัน Text.PadStart และ Text.PadEnd เพื่อระบุความกว้างของเขตข้อมูลตัวเลข และค่าเป็นการจัดชิดขวาหรือซ้าย ตัวอย่างเช่น ตัวอย่างต่อไปนี้จัดชิดซ้ายค่าสกุลเงินในเขตข้อมูลที่มี 28 อักขระ และจัดชิดขวาค่าสกุลเงินในเขตข้อมูลที่มี 14 อักขระ (เมื่อใช้แบบอักษร Monospace)

let
    amounts = {16305.32, 18794.16},
    result = Text.Format("    Beginning Balance           Ending Balance#(cr,lf)    #{0}#{1}",
    {
        Text.PadEnd(Number.ToText(amounts{0}, "C2"), 28), 
        Text.PadStart(Number.ToText(amounts{1}, "C2"), 14)
    })
in
    result

// Displays:
//    Beginning Balance           Ending Balance
//    $16,305.32                      $18,794.16

ส่วนต่อไปนี้แสดงข้อมูลโดยละเอียดเกี่ยวกับสตริงรูปแบบตัวเลขมาตรฐานแต่ละตัว

ตัวระบุรูปแบบสกุลเงิน (C)

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

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

สตริงผลลัพธ์ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าด้วยตัวระบุรูปแบบสกุลเงิน:

let
    Source = 
    {
        Number.ToText(12345.6789, "C"),
        Number.ToText(12345.6789, "C3"),
        Number.ToText(12345.6789, "C3", "da-DK")
    }
in
    Source 

// The example displays the following list on a system whose
// current culture is English (United States):
//       $12,345.68
//       $12,345.679
//       12.345,679 kr.

ตัวระบุรูปแบบทศนิยม (D)

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

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

สตริงผลลัพธ์ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าด้วยตัวระบุรูปแบบทศนิยม

let
    Source = 
    { 
        Number.ToText(12345, "D"),
        // Displays 12345

        Number.ToText(12345, "D8"),
        // Displays 00012345

        Number.ToText(-12345, "D"),
        // Displays -12345

        Number.ToText(-12345, "D8")
        // Displays -00012345
    }
in
    Source 

ตัวระบุรูปแบบเอ็กซ์โพเนนเชียล

ตัวระบุรูปแบบเอ็กซ์โพเนนเชียล แปลงตัวเลขเป็นสตริงของฟอร์ม "-d.ddd... E+ddd" หรือ "-d.ddd... e+ddd" ที่แต่ละ "d" ระบุตัวเลข (0-9) สตริงเริ่มต้นด้วยเครื่องหมายลบถ้าจํานวนเป็นลบ โดยที่ตัวเลขหนึ่งหลักจะนําหน้าจุดทศนิยมเสมอ

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

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

สตริงผลลัพธ์ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าด้วยตัวระบุรูปแบบเอ็กซ์โพเนนเชียล:

let
    Source = 
    { 
        Number.ToText(12345.6789, "E", ""),
        // Displays 1.234568E+004

        Number.ToText(12345.6789, "E10", ""),
        // Displays 1.2345678900E+004

        Number.ToText(12345.6789, "e4", ""),
        // 1.2346e+004

        Number.ToText(12345.6789, "E", "fr-FR")
        // Displays 1,234568E+004
    }
in
    Source 

หมายเหตุ

ค่าข้อความที่ว่างเปล่า ("") ในพารามิเตอร์สุดท้ายของ Number.ToText ในตัวอย่างก่อนหน้าหมายถึงวัฒนธรรมที่ไม่แปรเปลี่ยน

ตัวระบุรูปแบบจุดตายตัว (F)

ตัวระบุรูปแบบจุดทศนิยมตายตัว ("F") แปลงตัวเลขเป็นสตริงของฟอร์ม "-ddd.ddd..." โดยที่ "d" แต่ละรายการระบุตัวเลข (0-9) สตริงเริ่มต้นด้วยเครื่องหมายลบถ้าจํานวนเป็นลบ

ตัวระบุความแม่นยําจะระบุจํานวนตําแหน่งทศนิยมที่ต้องการ หากตัวระบุความแม่นยําถูกเว้นไว้ จํานวนเริ่มต้นของตําแหน่งทศนิยมที่จะใช้ในค่าตัวเลขคือ 2

สตริงผลลัพธ์ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าสองเท่าและจํานวนเต็มด้วยตัวระบุรูปแบบจุดทศนิยมตายตัว:

let
    Source =
    {
        Number.ToText(17843, "F", ""),
        // Displays 17843.00

        Number.ToText(-29541, "F3", ""),
        // Displays -29541.000

        Number.ToText(18934.1879, "F", ""),
        // Displays 18934.19

        Number.ToText(18934.1879, "F0", ""),
        // Displays 18934

        Number.ToText(-1898300.1987, "F1", ""),
        // Displays -1898300.2

        Number.ToText(-1898300.1987, "F3", "es-ES")
        // Displays -1898300,199
    }
in
    Source

ตัวระบุรูปแบบทั่วไป (G)

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

ชนิดตัวเลข ความแม่นยําเริ่มต้น
Byte.Type หรือ Int8.Type มี 3 หลัก
Int16.Type มี 5 หลัก
Int32.Type มี 10 หลัก
Int64.Type มี 19 หลัก
Single.Type มี 9 หลัก
Double.Type มี 17 หลัก
Decimal.Type มี 15 หลัก

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

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

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

สตริงผลลัพธ์ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าจุดทศนิยมลอยตัวที่จัดประเภทด้วยตัวระบุรูปแบบทั่วไป:

let
    Source =
    {
        Number.ToText(12345.6789, "G", ""),
        // Displays 12345.6789

        Number.ToText(12345.6789, "G", "fr-FR"),
        // Displays 12345,6789

        Number.ToText(12345.6789, "G7", ""),
        // Displays 12345.68

        Number.ToText(.0000023, "G", ""),
        // Displays 2.3E-06

        Number.ToText(.0000023, "G", "fr-FR"),
        // Displays 2,3E-06

        Number.ToText(.0023, "G", ""),
        // Displays 0.0023

        Number.ToText(1234, "G2", ""),
        // Displays 1.2E+03

        Number.ToText(Number.PI, "G5", "")
        // Displays 3.1416
    }
in
    Source

ตัวระบุรูปแบบตัวเลข (N)

ตัวระบุรูปแบบตัวเลข ("N") แปลงตัวเลขเป็นสตริงของแบบฟอร์ม "-ddd,ddd.ddd..." โดยที่ "-" ระบุสัญลักษณ์จํานวนลบถ้าจําเป็น "d" ระบุตัวเลข (0-9), "," ระบุตัวคั่นกลุ่ม และ "." ระบุสัญลักษณ์จุดทศนิยม ตัวระบุความแม่นยําจะระบุจํานวนหลักที่ต้องการหลังจากจุดทศนิยม หากตัวระบุความแม่นยําถูกเว้นไว้ จะมีการกําหนดจํานวนตําแหน่งทศนิยมโดยวัฒนธรรมปัจจุบัน

สตริงผลลัพธ์ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าจุดทศนิยมลอยตัวที่มีการระบุรูปแบบตัวเลข:

let
    Source =
    {
        Number.ToText(-12445.6789, "N", ""),
        // Displays -12,445.68

        Number.ToText(-12445.6789, "N1", "sv-SE"),
        // Displays -12 445,7

        Number.ToText(123456789, "N1", "")
        // Displays 123,456,789.0
    }
in
    Source

ตัวระบุรูปแบบเปอร์เซ็นต์ (P)

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

ตัวอย่างต่อไปนี้จัดรูปแบบค่าจุดทศนิยมลอยตัวด้วยตัวระบุรูปแบบเปอร์เซ็นต์:

let
    Source =
    {
        Number.ToText(.2468013, "P", ""),
        // Displays 24.68 %

        Number.ToText(.2468013, "P", "hr-HR"),
        // Displays 24,68 %

        Number.ToText(.2468013, "P1", "en-US")
        // Displays 24.7%
    }
in
    Source

ตัวระบุรูปแบบฐานสิบหก (X)

ตัวระบุรูปแบบฐานสิบหก ("X") แปลงตัวเลขเป็นสตริงของตัวเลขฐานสิบหก ตัวระบุรูปแบบจะระบุว่าจะใช้อักขระตัวพิมพ์ใหญ่หรือตัวพิมพ์เล็กสําหรับเลขฐานสิบหกที่มากกว่า 9 หรือไม่ ตัวอย่างเช่น ใช้ "X" เพื่อสร้าง "ABCDEF" และ "x" เพื่อสร้าง "abcdef" รูปแบบนี้ได้รับการสนับสนุนสําหรับชนิดจํานวนเต็มเท่านั้น

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

สตริงผลลัพธ์ไม่ได้รับผลกระทบจากการจัดรูปแบบข้อมูลของวัฒนธรรมปัจจุบัน

ตัวอย่างต่อไปนี้จัดรูปแบบค่าด้วยตัวระบุรูปแบบเลขฐานสิบหก

let
    Source =
    {
        Number.ToText(0x2045e, "x"),
        // Displays 2045e

        Number.ToText(0x2045e, "X"),
        // Displays 2045E

        Number.ToText(0x2045e, "X8"),
        // Displays 0002045E

        Number.ToText(123456789, "X"),
        // Displays 75BCD15

        Number.ToText(123456789, "X2")
        // Displays 75BCD15
    }
in
    Source

บันทึกย่อ

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

ชนิดตัวเลขจํานวนเต็มและจุดทศนิยมลอยตัว

คําอธิบายบางอย่างของตัวระบุรูปแบบตัวเลขมาตรฐานอ้างอิงถึงชนิดตัวเลขจํานวนเต็มหรือจุดทศนิยมลอยตัว ชนิดตัวเลขจํานวนเต็มคือ Byte.Type, Int8.Type, Int16.Type, Int32.Type, และInt64.Type ชนิดตัวเลขจุดทศนิยมลอยตัวคือ Decimal.Type, Single.TypeและDouble.Type

ค่าอินฟินิตี้จุดทศนิยมและ NaN

โดยไม่คํานึงถึงสตริงรูปแบบ ถ้าค่าของ Decimal.TypeSingle.Type หรือ Double.Type ชนิดจุดทศนิยมทศนิยมเป็นค่าอินฟินิตี้ด้านบวก ค่าอินฟินิตี้ด้านลบ หรือไม่ใช่ตัวเลข (NaN) สตริงที่จัดรูปแบบคือค่าของค่าคงที่ Number.PositiveInfinityNumber.NegativeInfinityหรือ Number.NaN ค่าคงที่ที่ระบุโดยวัฒนธรรมที่ใช้ในปัจจุบัน

ตัวอย่างโค้ด

ตัวอย่างต่อไปนี้จัดรูปแบบจุดทศนิยมลอยตัวและค่าตัวเลขจํานวนเต็มโดยใช้วัฒนธรรม en-US และตัวระบุรูปแบบตัวเลขมาตรฐานทั้งหมด ตัวอย่างนี้ใช้ชนิดตัวเลขเฉพาะสองชนิด (Double.Type และ Int32.Type) แต่จะให้ผลลัพธ์ที่คล้ายกันสําหรับชนิดฐานตัวเลขอื่นๆ (Byte.Type, Decimal.Type, Int8.Type, Int16.Type, Int64.Type, และ Single.Type)

let
    // Display text representations of numbers for en-US culture
    culture = "en-US",

    // Output floating point values
    floating = Double.From(10761.937554),
    #"Floating results" = 
    {
        Text.Format("C: #{0}", {Number.ToText(floating, "C", culture)}),         // Displays "C: $10,761.94"
        Text.Format("E: #{0}", {Number.ToText(floating, "E03", culture)}),       // Displays "E: 1.076E+004"
        Text.Format("F: #{0}", {Number.ToText(floating, "F04", culture)}),       // Displays "F: 10761.9376"
        Text.Format("G: #{0}", {Number.ToText(floating, "G", culture)}),         // Displays "G: 10761.937554"
        Text.Format("N: #{0}", {Number.ToText(floating, "N03", culture)}),       // Displays "N: 10,761.938"
        Text.Format("P: #{0}", {Number.ToText(floating/10000, "P02", culture)})  // Displays "P: 107.62%"
    },
    
    // Output integral values
    integral = Int32.From(8395),
    #"Integral results" =
    {
        Text.Format("C: #{0}", {Number.ToText(integral, "C", culture)}),         // Displays "C: $8,395.00"
        Text.Format("D: #{0}", {Number.ToText(integral, "D6", culture)}),        // Displays "D: 008395"
        Text.Format("E: #{0}", {Number.ToText(integral, "E03", culture)}),       // Displays "E: 8.395E+003"
        Text.Format("F: #{0}", {Number.ToText(integral, "F01", culture)}),       // Displays "F: 8395.0"
        Text.Format("G: #{0}", {Number.ToText(integral, "G", culture)}),         // Displays "G: 8395"
        Text.Format("N: #{0}", {Number.ToText(integral, "N01", culture)}),       // Displays "N: 8,395.0"
        Text.Format("P: #{0}", {Number.ToText(integral/10000, "P02", culture)}), // Displays "P: 83.95%"
        Text.Format("X: 0x#{0}", {Number.ToText(integral, "X", culture)})        // Displays "X: 0x20CB"
    },
    results = #"Floating results" & #"Integral results"

in
    results