Function ng Format

Kino-convert ang isang numeric na expression sa isang string, at pagkatapos ay i-format ito ayon sa format na iyong tinukoy.

Syntax:


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

Mga Parameter:

pagpapahayag : Numeric na expression na gusto mong i-convert sa isang na-format na string.

pormat : String na tumutukoy sa format code para sa numero. Kung pormat ay tinanggal, ang Format function ay gumagana tulad ng LibreOfficeDev Basic Str() function.

Ibinalik na halaga:

Text string.

Mga Code sa Pag-format

A pormat maaaring hatiin ang code sa tatlong seksyon na pinaghihiwalay ng mga semicolon. Tinutukoy ng unang bahagi ang format para sa mga positibong halaga, ang pangalawang bahagi para sa mga negatibong halaga, at ang ikatlong bahagi para sa zero. Kung isa lang ang tinukoy mo pormat code, nalalapat ito sa lahat ng numero.

Maaari mong itakda ang lokal na ginagamit para sa pagkontrol sa pag-format ng mga numero, petsa at pera sa LibreOfficeDev Basic sa - Mga Wika at Lokal - Pangkalahatan . Sa Basic na format code, ang decimal point ( . ) ay palaging ginagamit bilang placeholder para sa decimal separator na tinukoy sa iyong lokal at papalitan ng kaukulang character.

Ang parehong naaangkop sa mga setting ng lokal para sa mga format ng petsa, oras at pera. Ang Basic format code ay bibigyang-kahulugan at ipapakita ayon sa iyong setting ng lokal.

Inilalarawan ng sumusunod na listahan ang mga code na maaari mong gamitin para sa pag-format ng isang numeric na expression:

Code

Description

0

If expression has a digit at the position of the 0 in the format code, the digit is displayed, otherwise a zero is displayed.

Kung pagpapahayag ay may mas kaunting mga digit kaysa sa bilang ng mga zero sa pormat code, (sa magkabilang panig ng decimal), ang mga nangunguna o sumusunod na mga zero ay ipinapakita. Kung ang pagpapahayag ay may mas maraming digit sa kaliwa ng decimal separator kaysa sa halaga ng mga zero sa pormat code, ang mga karagdagang digit ay ipinapakita nang walang pag-format.

Mga desimal na lugar sa pagpapahayag ay bilugan ayon sa bilang ng mga zero na lumilitaw pagkatapos ng decimal separator sa pormat code.

#

If expression contains a digit at the position of the # placeholder in the format code, the digit is displayed, otherwise nothing is displayed at this position.

Gumagana ang simbolo na ito tulad ng 0, maliban na ang mga nangunguna o sumusunod na mga zero ay hindi ipinapakita kung mayroong higit pang # na character sa pormat code kaysa sa mga digit sa pagpapahayag . Tanging ang mga kaugnay na digit ng pagpapahayag ay ipinapakita.

. (period)

The decimal placeholder determines the number of decimal places to the left and right of the decimal separator.

Kung ang pormat Ang code ay naglalaman lamang ng # na placeholder sa kaliwa ng simbolong ito, ang mga numerong mas mababa sa 1 ay nagsisimula sa isang decimal separator. Upang palaging magpakita ng nangungunang zero na may mga fractional na numero, gamitin ang 0 bilang isang placeholder para sa unang digit sa kaliwa ng decimal separator.

Ang paggamit ng isang tuldok bilang isang libo at decimal separator ay nakadepende sa rehiyonal na setting. Kapag direkta kang naglagay ng numero sa Basic source code, palaging gumamit ng tuldok bilang decimal delimiter. Ang aktwal na character na ipinapakita bilang isang decimal separator ay depende sa format ng numero sa iyong mga setting ng system.

%

%: Pinaparami ang pagpapahayag sa pamamagitan ng 100 at ipinapasok ang porsyentong tanda (%) kung saan ang pagpapahayag lumilitaw sa pormat code.

E- E+ e- e+

E- E+ e- e+ : Kung ang pormat naglalaman ang code ng hindi bababa sa isang digit na placeholder (0 o #) sa kanan ng simbolo na E-, E+, e-, o e+, ang pagpapahayag ay naka-format sa pang-agham o exponential na format. Ang titik E o e ay ipinasok sa pagitan ng numero at ng exponent. Tinutukoy ng bilang ng mga placeholder para sa mga digit sa kanan ng simbolo ang bilang ng mga digit sa exponent.

Kung negatibo ang exponent, direktang ipinapakita ang isang minus sign bago ang exponent na may E-, E+, e-, e+. Kung positibo ang exponent, ipinapakita lang ang plus sign bago ang mga exponent na may E+ o e+.

- + $ ( ) space

- + $ ( ) espasyo: Isang plus (+), minus (-), dollar ($), space, o mga bracket na direktang ipinasok sa pormat code ay ipinapakita bilang isang literal na character.

\

Upang magpakita ng mga character maliban sa mga nakalista dito, dapat mo itong unahan ng backslash (\), o ilakip ito sa mga panipi (" ").

\ : Ipinapakita ng backslash ang susunod na character sa pormat code.

Mga tauhan sa pormat Ang code na may espesyal na kahulugan ay maipapakita lamang bilang literal na mga character kung ang mga ito ay pinangungunahan ng backslash. Ang backslash mismo ay hindi ipinapakita, maliban kung maglagay ka ng double backslash (\\) sa format code.

Ang mga character na dapat unahan ng backslash sa format code upang maipakita bilang literal na mga character ay mga character na nag-format ng petsa at oras (a, c, d, h, m, n, p, q, s, t, w , y, /, :), numeric-formatting na mga character (#, 0, %, E, e, kuwit, tuldok), at string-formatting na mga character (@, &, <, >, !).


Paunang natukoy na format

Maaari mo ring gamitin ang mga sumusunod na paunang natukoy na mga format ng numero. Maliban sa "Pangkalahatang Numero" , ibinabalik ng lahat ng paunang natukoy na format na code ang numero bilang isang decimal na numero na may dalawang decimal na lugar.

Kung gumagamit ka ng mga paunang natukoy na format, ang pangalan ng format ay dapat na nakapaloob sa mga panipi.

Code

Description

"<"

Convert expression to lower case

">"

Convert expression to upper case.

"c" or "General Date"

Returns the numeric expression in short date format, optionally with "H:MM:SS AM/PM". If expression is a string, returns the string.

"n"

Returns the minute of the numeric expression, with 1 or 2 digits.

"nn"

Returns the minute of the numeric expression with two digits.

"w"

Returns the week day of the numeric expression. 1 is Sunday and 7 is Saturday.

"General Number"

Returns the numeric expression with 12 digits (0.############).

"Currency"

Returns the numeric expression in the currency of the locale.

"Fixed"

Returns the numeric expression with 2 decimal places (0.00).

"Standard"

Returns the numeric expression with thousands separators and 2 decimals (@0.00).

"Percent"

Returns the numeric expression as percent value (0.00%).

"Scientific"

Returns the numeric expression in scientific notation (#.00E+00);

"Yes/No"

Returns "Yes" if the numeric expression is not equal to zero, "No" otherwise. "Yes" and "No" are localized.

"True/False"

Returns "True" if the numeric expression is not equal to zero, "False" otherwise. "True" and "False" are localized.

"On/Off"

Returns "On" if the numeric expression is not equal to zero, "Off" otherwise. "On" and "Off" are localized.

"Long Date" or "dddddd"

Returns the numeric expression in system long date format, and depends on the locale.

"Medium Date"

Returns the numeric expression in date format DD-MMM-YY, and depends on the locale.

"Short Date" or "ddddd"

Returns the numeric expression in system short date format, and depends on the locale.

"Long Time" or "ttttt"

Returns the numeric expression in system long time format, and depends on the locale("H:MM:SS AM/PM").

"Medium Time"

Returns the numeric expression in system medium time format, and depends on the locale (HH:MM AM/PM)

"Short Time"

Returns the numeric expression in system short time format, and depends on the locale (HH:MM).


Mga error code:

5 Di-wastong procedure call

Halimbawa:


Sub ExampleFormat
    MsgBox Format(6328.2, "##,##0.00")
    ' laging gumamit ng tuldok bilang decimal delimiter kapag naglagay ka ng mga numero sa Basic source code.
    ' ay nagpapakita ng halimbawa 6,328.20 sa English locale, 6.328,20 sa German locale.
msgbox Format("ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890", "<") ' returns abcdefghijklmnopqrstuvwxyz1234567890, digits not affected.
msgbox Format("abcdefghijklmnopqrstuvwxyz1234567890", ">") ' returns ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890, digits not affected.
msgBox Format(12345.6,"c") ' returns the number in date format as 18/10/33 2:24:00 PM in German locale.
msgBox Format(12345.6,"General Date") ' Same as "c".
msgbox format(12345.004,"n") ' returns 5
msgbox format(12345.004,"nn") ' returns 05
msgbox format(12345.6,"w") ' returns 4 (Wednesday).
msgbox format(log(123),"General Number") ' returns 4,812184355372 in German locale
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") ' returns localized "Yes"
msgbox format(0,"Yes/No") ' returns localized "No"
msgbox format(-1,"True/False") ' returns localized "True"
msgbox format(123,"On/Off") ' returns localized "On"
msgbox format(45756.73,"Long Date") ' returns Wednesday, April 9, 2025 in your locale
End Sub