ເນື້ອໃນ

# ຟັງຊັນ Format

ແປງນິພົດຕົວເລກໃຫ້ເປັນສະຕຣິງ, ແລ້ວຈັດຮູບແບບຕາມທີ່ທ່ານກຳນົດ.

### ໄວຍາກອນ:

    Format(expression [, format As String]) As String

### ພາຣາມິເຕີ:

expression: ນິພົດຕົວເລກທີ່ທ່ານຕ້ອງການແປງເປັນສະຕຣິງທີ່ມີຮູບແບບ.

format: ສະຕຣິງທີ່ກຳນົດລະຫັດຮູບແບບສຳລັບຕົວເລກ. ຖ້າລະເວັ້ນ format, ຟັງຊັນ Format ຈະເຮັດວຽກຄືກັບ ຟັງຊັນ Str() ຂອງ LibreOffice Basic.

### ປະເພດຄ່າທີ່ສົ່ງກັບ:

ສະຕຣິງຂໍ້ຄວາມ.

## ລະຫັດການຈັດຮູບແບບ

ໃນ BASIC, ລະຫັດ format ສາມາດແບ່ງອອກເປັນສາມພາກສ່ວນທີ່ແຍກກັນດ້ວຍຈໍ້າຈຸດ. ພາກສ່ວນທຳອິດກຳນົດຮູບແບບສຳລັບຄ່າບວກ, ພາກສ່ວນທີສອງສຳລັບຄ່າລົບ, ແລະ ພາກສ່ວນທີສາມສຳລັບສູນ. ຖ້າທ່ານກຳນົດພຽງແຕ່ລະຫັດ format ດຽວ, ມັນຈະຖືກນຳໃຊ້ກັບຕົວເລກທັງໝົດ.

ທ່ານສາມາດຕັ້ງຄ່າທ້ອງຖິ່ນ (locale) ທີ່ໃຊ້ເພື່ອຄວບຄຸມການຈັດຮູບແບບຕົວເລກ, ວັນທີ ແລະ ສະກຸນເງິນໃນ LibreOffice Basic ໄດ້ທີ່ LibreOffice - ປັບແຕ່ງເຄື່ອງມື - ຕົວເລືອກ - ພາສາ ແລະ ການຕັ້ງຄ່າທ້ອງຖິ່ນ - ທົ່ວໄປ. ໃນລະຫັດຮູບແບບຂອງ Basic, ຈຸດທົດສະນິຍົມ (.) ຈະຖືກໃຊ້ເປັນ ຕົວຈອງບ່ອນ (placeholder) ສຳລັບຕົວແຍກທົດສະນິຍົມທີ່ກຳນົດໄວ້ໃນທ້ອງຖິ່ນຂອງທ່ານ ແລະ ຈະຖືກແທນທີ່ດ້ວຍຕົວອັກສອນທີ່ກ່ຽວຂ້ອງ.

ສິ່ງດຽວກັນນີ້ກໍໃຊ້ກັບການຕັ້ງຄ່າທ້ອງຖິ່ນສຳລັບຮູບແບບວັນທີ, ເວລາ ແລະ ສະກຸນເງິນ. ລະຫັດຮູບແບບ Basic ຈະຖືກແປ ແລະ ສະແດງຜົນຕາມການຕັ້ງຄ່າທ້ອງຖິ່ນຂອງທ່ານ.

ລາຍການຕໍ່ໄປນີ້ອະທິບາຍລະຫັດທີ່ທ່ານສາມາດໃຊ້ເພື່ອຈັດຮູບແບບນິພົດຕົວເລກ:

ລະຫັດ | ຄຳອະທິບາຍ
--- | ---
0 | ຖ້າ expression ມີຕົວເລກໃນຕຳແໜ່ງຂອງ 0 ໃນລະຫັດ format, ຕົວເລກນັ້ນຈະຖືກສະແດງ, ຖ້າບໍ່ດັ່ງນັ້ນຈະສະແດງເລກສູນ. ຖ້າ expression ມີຕົວເລກໜ້ອຍກວ່າຈຳນວນເລກສູນໃນລະຫັດ format (ທັງສອງດ້ານຂອງທົດສະນິຍົມ), ເລກສູນນຳໜ້າ ຫຼື ຕາມຫຼັງຈະຖືກສະແດງ. ຖ້າ expression ມີຕົວເລກທາງດ້ານຊ້າຍຂອງເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມຫຼາຍກວ່າຈຳນວນເລກສູນໃນລະຫັດ format, ຕົວເລກທີ່ເກີນມາຈະຖືກສະແດງໂດຍບໍ່ມີການຈັດຮູບແບບ. ຕຳແໜ່ງທົດສະນິຍົມໃນ expression ຈະຖືກປັດຕາມຈຳນວນເລກສູນທີ່ປະກົດຫຼັງເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມໃນລະຫັດ format.
# | ຖ້າ expression ມີຕົວເລກໃນຕຳແໜ່ງຂອງຕົວແທນ # ໃນລະຫັດ format, ຕົວເລກນັ້ນຈະຖືກສະແດງ, ຖ້າບໍ່ດັ່ງນັ້ນຈະບໍ່ມີຫຍັງສະແດງໃນຕຳແໜ່ງນີ້. ສັນຍະລັກນີ້ເຮັດວຽກຄືກັບ 0, ຍົກເວັ້ນແຕ່ເລກສູນນຳໜ້າ ຫຼື ຕາມຫຼັງຈະບໍ່ຖືກສະແດງ ຖ້າມີຕົວອັກສອນ # ໃນລະຫັດ format ຫຼາຍກວ່າຈຳນວນຕົວເລກໃນ expression. ຈະມີພຽງຕົວເລກທີ່ກ່ຽວຂ້ອງຂອງ expression ເທົ່ານັ້ນທີ່ຈະຖືກສະແດງ.
. (period) | ຕົວແທນທົດສະນິຍົມກຳນົດຈຳນວນຕຳແໜ່ງທົດສະນິຍົມທາງດ້ານຊ້າຍ ແລະ ຂວາຂອງເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມ. ຖ້າລະຫັດ format ມີພຽງຕົວແທນ # ທາງດ້ານຊ້າຍຂອງສັນຍະລັກນີ້, ຕົວເລກທີ່ໜ້ອຍກວ່າ 1 ຈະເລີ່ມຕົ້ນດ້ວຍເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມ. ເພື່ອໃຫ້ສະແດງເລກສູນນຳໜ້າສະເໝີກັບຕົວເລກເສດ, ໃຫ້ໃຊ້ 0 ເປັນຕົວແທນສຳລັບຕົວເລກທຳອິດທາງດ້ານຊ້າຍຂອງເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມ. ການໃຊ້ຈຸດເປັນເຄື່ອງໝາຍຂັ້ນຫຼັກພັນ ຫຼື ທົດສະນິຍົມແມ່ນຂຶ້ນກັບການຕັ້ງຄ່າພາກພື້ນ. ເມື່ອທ່ານປ້ອນຕົວເລກໂດຍກົງໃນຊອດໂຄ້ດ Basic, ໃຫ້ໃຊ້ຈຸດເປັນເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມສະເໝີ. ຕົວອັກສອນຕົວຈິງທີ່ຈະສະແດງແມ່ນຂຶ້ນກັບຮູບແບບຕົວເລກໃນການຕັ້ງຄ່າລະບົບຂອງທ່ານ.
% | ຄູນ expression ດ້ວຍ 100 ແລະ ແຊກເຄື່ອງໝາຍເປີເຊັນ (%) ໃນຕຳແໜ່ງທີ່ expression ປະກົດໃນລະຫັດ format.
E- E+ e- e+ | ຖ້າລະຫັດ format ມີຕົວແທນຕົວເລກຢ່າງໜ້ອຍໜຶ່ງຕົວ (0 ຫຼື #) ທາງຂວາຂອງສັນຍະລັກ E-, E+, e-, ຫຼື e+, expression ຈະຖືກຈັດຮູບແບບເປັນແບບວິທະຍາສາດ ຫຼື ເລກກຳລັງ. ຕົວອັກສອນ E ຫຼື e ຈະຖືກແຊກລະຫວ່າງຕົວເລກ ແລະ ເລກກຳລັງ. ຈຳນວນຕົວແທນສຳລັບຕົວເລກທາງຂວາຂອງສັນຍະລັກຈະກຳນົດຈຳນວນຫຼັກໃນເລກກຳລັງ. ຖ້າເລກກຳລັງເປັນຄ່າລົບ, ເຄື່ອງໝາຍລົບຈະຖືກສະແດງທາງໜ້າເລກກຳລັງໂດຍກົງກັບ E-, E+, e-, e+. ຖ້າເລກກຳລັງເປັນຄ່າບວກ, ເຄື່ອງໝາຍບວກຈະສະແດງສະເພາະທາງໜ້າເລກກຳລັງທີ່ມີ E+ ຫຼື e+ ເທົ່ານັ້ນ.
- + $ ( ) space | ເຄື່ອງໝາຍບວກ (+), ລົບ (-), ໂດລາ ($), ຊ່ອງຫວ່າງ ຫຼື ວົງເລັບ ທີ່ປ້ອນໂດຍກົງໃນລະຫັດ format ຈະຖືກສະແດງເປັນຕົວອັກສອນຕາມນັ້ນ.
\ | ເພື່ອສະແດງຕົວອັກສອນອື່ນນອກຈາກທີ່ລະບຸຢູ່ນີ້, ທ່ານຕ້ອງໃສ່ເຄື່ອງໝາຍ backslash (\) ນຳໜ້າ, ຫຼື ຂັງໄວ້ໃນເຄື່ອງໝາຍຄຳເວົ້າ (" "). Backslash ຈະສະແດງຕົວອັກສອນຖັດໄປໃນລະຫັດ format. ຕົວອັກສອນໃນລະຫັດ format ທີ່ມີຄວາມໝາຍພິເສດ ຈະສາມາດສະແດງເປັນຕົວອັກສອນປົກກະຕິໄດ້ກໍຕໍ່ເມື່ອມີ backslash ນຳໜ້າ. ຕົວ backslash ເອງຈະບໍ່ຖືກສະແດງ, ຍົກເວັ້ນທ່ານຈະປ້ອນ backslash ສອງຕົວ (\\) ໃນລະຫັດຮູບແບບ. ຕົວອັກສອນທີ່ຕ້ອງມີ backslash ນຳໜ້າໃນລະຫັດຮູບແບບເພື່ອໃຫ້ສະແດງເປັນຕົວອັກສອນປົກກະຕິ ໄດ້ແກ່ ຕົວອັກສອນຈັດຮູບແບບວັນທີ ແລະ ເວລາ (a, c, d, h, m, n, p, q, s, t, w, y, /, :), ຕົວອັກສອນຈັດຮູບແບບຕົວເລກ (#, 0, %, E, e, ຈຸດ, ຈ້ຳ), ແລະ ຕົວອັກສອນຈັດຮູບແບບສະຕຣິງ (@, &, <, >, !).

## ຮູບແບບທີ່ກຳນົດໄວ້ລ່ວງໜ້າ

ທ່ານຍັງສາມາດໃຊ້ຮູບແບບຕົວເລກທີ່ກຳນົດໄວ້ລ່ວງໜ້າຕໍ່ໄປນີ້. ຍົກເວັ້ນ "General Number", ລະຫັດຮູບແບບທີ່ກຳນົດໄວ້ລ່ວງໜ້າທັງໝົດຈະສົ່ງຄືນຕົວເລກເປັນທົດສະນິຍົມສອງຕຳແໜ່ງ.

ຖ້າທ່ານໃຊ້ຮູບແບບທີ່ກຳນົດໄວ້ລ່ວງໜ້າ, ຊື່ຂອງຮູບແບບນັ້ນຕ້ອງຂັງໄວ້ໃນເຄື່ອງໝາຍຄຳເວົ້າ.

ລະຫັດ | ຄຳອະທິບາຍ
--- | ---
"<" | ແປງ expression ໃຫ້ເປັນຕົວພິມນ້ອຍ.
">" | ແປງ expression ໃຫ້ເປັນຕົວພິມໃຫຍ່.
"c" or "General Date" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບວັນທີແບບສັ້ນ, ອາດຈະມີ "H:MM:SS AM/PM" ນຳ. ຖ້າ expression ແມ່ນສະຕຣິງ, ຈະສົ່ງຄືນສະຕຣິງນັ້ນ.
"n" | ສົ່ງຄືນນາທີຂອງນິພົດຕົວເລກ, ດ້ວຍ 1 ຫຼື 2 ຫຼັກ.
"nn" | ສົ່ງຄືນນາທີຂອງນິພົດຕົວເລກດ້ວຍສອງຫຼັກ.
"w" | ສົ່ງຄືນວັນໃນອາທິດຂອງນິພົດຕົວເລກ. 1 ແມ່ນ ວັນອາທິດ ແລະ 7 ແມ່ນ ວັນເສົາ.
"General Number" | ສົ່ງຄືນ expression ຕົວເລກທີ່ມີ 12 ຫຼັກ (0.############).
"Currency" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບເງິນຕາຕາມການຕັ້ງຄ່າທ້ອງຖິ່ນ.
"Fixed" | ສົ່ງຄືນ expression ຕົວເລກທີ່ມີທົດສະນິຍົມ 2 ຕຳແໜ່ງ (0.00).
"Standard" | ສົ່ງຄືນ expression ຕົວເລກທີ່ມີເຄື່ອງໝາຍຂັ້ນຫຼັກພັນ ແລະ ທົດສະນິຍົມ 2 ຕຳແໜ່ງ (@0.00).
"Percent" | ສົ່ງຄືນ expression ຕົວເລກເປັນຄ່າເປີເຊັນ (0.00%).
"Scientific" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບວິທະຍາສາດ (#.00E+00).
"Yes/No" | ສົ່ງຄືນ "Yes" ຖ້າ expression ຕົວເລກບໍ່ເທົ່າກັບສູນ, ຖ້າບໍ່ດັ່ງນັ້ນສົ່ງຄືນ "No". "Yes" ແລະ "No" ຈະຖືກປ່ຽນຕາມພາສາທ້ອງຖິ່ນ.
"True/False" | ສົ່ງຄືນ "True" ຖ້າ expression ຕົວເລກບໍ່ເທົ່າກັບສູນ, ຖ້າບໍ່ດັ່ງນັ້ນສົ່ງຄືນ "False". "True" ແລະ "False" ຈະຖືກປ່ຽນຕາມພາສາທ້ອງຖິ່ນ.
"On/Off" | ສົ່ງຄືນ "On" ຖ້າ expression ຕົວເລກບໍ່ເທົ່າກັບສູນ, ຖ້າບໍ່ດັ່ງນັ້ນສົ່ງຄືນ "Off". "On" ແລະ "Off" ຈະຖືກປ່ຽນຕາມພາສາທ້ອງຖິ່ນ.
"Long Date" or "dddddd" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບວັນທີແບບຍາວຂອງລະບົບ, ເຊິ່ງຂຶ້ນກັບການຕັ້ງຄ່າທ້ອງຖິ່ນ.
"Medium Date" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບວັນທີ DD-MMM-YY, ເຊິ່ງຂຶ້ນກັບການຕັ້ງຄ່າທ້ອງຖິ່ນ.
"Short Date" or "ddddd" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບວັນທີແບບສັ້ນຂອງລະບົບ, ເຊິ່ງຂຶ້ນກັບການຕັ້ງຄ່າທ້ອງຖິ່ນ.
"Long Time" or "ttttt" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບເວລາແບບຍາວຂອງລະບົບ, ເຊິ່ງຂຶ້ນກັບການຕັ້ງຄ່າທ້ອງຖິ່ນ ("H:MM:SS AM/PM").
"Medium Time" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບເວລາແບບກາງຂອງລະບົບ, ເຊິ່ງຂຶ້ນກັບການຕັ້ງຄ່າທ້ອງຖິ່ນ (HH:MM AM/PM).
"Short Time" | ສົ່ງຄືນ expression ຕົວເລກໃນຮູບແບບເວລາແບບສັ້ນຂອງລະບົບ, ເຊິ່ງຂຶ້ນກັບການຕັ້ງຄ່າທ້ອງຖິ່ນ (HH:MM).

### ລະຫັດຂໍ້ຜິດພາດ:

5 ການເອີ້ນໃຊ້ໂປຣຊີເຈີບໍ່ຖືກຕ້ອງ

### ຕົວຢ່າງ:

    Sub ExampleFormat
        MsgBox Format(6328.2, "##,##0.00")
        ' ໃຫ້ໃຊ້ຈຸດເປັນເຄື່ອງໝາຍຂັ້ນທົດສະນິຍົມສະເໝີ ເມື່ອທ່ານປ້ອນຕົວເລກໃນຊອດໂຄ້ດ Basic.
        ' ສະແດງຕົວຢ່າງ 6,328.20 ໃນພາສາອັງກິດ, 6.328,20 ໃນພາສາເຢຍລະມັນ.
    msgbox Format("ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890", "<") ' ສົ່ງຄືນ abcdefghijklmnopqrstuvwxyz1234567890, ຕົວເລກຈະບໍ່ໄດ້ຮັບຜົນກະທົບ.
    msgbox Format("abcdefghijklmnopqrstuvwxyz1234567890", ">") ' ສົ່ງຄືນ ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890, ຕົວເລກຈະບໍ່ໄດ້ຮັບຜົນກະທົບ.
    msgBox Format(12345.6,"c") ' ສົ່ງຄືນຕົວເລກໃນຮູບແບບວັນທີ ເຊັ່ນ 18/10/33 2:24:00 PM ໃນພາສາເຢຍລະມັນ.
    msgBox Format(12345.6,"General Date") ' ຄືກັນກັບ "c".
    msgbox format(12345.004,"n") ' ສົ່ງຄືນ 5
    msgbox format(12345.004,"nn") ' ສົ່ງຄືນ 05
    msgbox format(12345.6,"w") ' ສົ່ງຄືນ 4 (ວັນພຸດ).
    msgbox format(log(123),"General Number") ' ສົ່ງຄືນ 4,812184355372 ໃນພາສາເຢຍລະມັນ
    msgbox format(123456.7890,"Fixed") ' 123456.79
    msgbox format(123456.1234,"Fixed") ' 123456.12
    msgbox format(123456.7890,"Standard") '123,456.79
    msgbox format(123456.1234,"Standard") '123,456.12
    msgbox format(12.3456,"Percent") ' 1234.56%
    msgbox format(0.123456,"Percent") '12.35%
    msgbox format(123,"Yes/No") ' ສົ່ງຄືນ "Yes" ຕາມພາສາທ້ອງຖິ່ນ
    msgbox format(0,"Yes/No") ' ສົ່ງຄືນ "No" ຕາມພາສາທ້ອງຖິ່ນ
    msgbox format(-1,"True/False") ' ສົ່ງຄືນ "True" ຕາມພາສາທ້ອງຖິ່ນ
    msgbox format(123,"On/Off") ' ສົ່ງຄືນ "On" ຕາມພາສາທ້ອງຖິ່ນ
    msgbox format(45756.73,"Long Date") ' ສົ່ງຄືນ Wednesday, April 9, 2025 ໃນການຕັ້ງຄ່າຂອງທ່ານ
    End Sub

ຫົວຂໍ້ທີ່ກ່ຽວຂ້ອງ

ລະຫັດຮູບແບບຕົວເລກ

ຟັງຊັນກ່ຽວກັບຂໍ້ຄວາມ (String)

ກະລຸນາສະໜັບສະໜູນພວກເຮົາ!