Formatfunksjon

Konverterer et numerisk uttrykk til en streng, og formaterer det deretter i henhold til formatet du angir.

Syntaks:


Format(uttrykk [, format som streng]) Som streng

Parametre:

uttrykk: Numerisk uttrykk som du vil konvertere til en formatert streng.

format: Streng som spesifiserer formatkoden for nummeret. Hvis format er utelatt, fungerer Format-funksjonen som LibreOffice Basic Str()-funksjonen.

Returtype:

Tekststreng.

Formatering av koder

I BASIC kan en format kode deles inn i tre seksjoner som er atskilt med semikolon. Den første delen definerer formatet for positive verdier, den andre delen for negative verdier, og den tredje delen for null. Hvis du bare angir én format kode, gjelder den for alle tall.

Du kan angi lokale innstillinger som brukes for å kontrollere formateringen av tall, datoer og valutaer i LibreOffice Basic i - Språk og lokale - Generelt. I Basic-formatkoder brukes alltid desimaltegn (.) som plassholder for desimalskilletegn som er definert i lokaliteten din, og vil bli erstattet av det tilsvarende tegnet.

Det samme gjelder for de lokale innstillingene for dato-, tid- og valuta-format. Basic-formatet vil bli tolket og vist i samband, med til de lokale språkinnstillingene.

Følgende liste beskriver kodene du kan bruke for å formatere et numerisk uttrykk:

Kode

Beskrivelse

0

Hvis uttrykk har et siffer på posisjonen til 0-en i format-koden, vises sifferet, ellers vises en null.

Hvis uttrykket har færre sifre enn antallet nuller i format-koden, (på hver side av desimalen), vises innledende eller etterfølgende nuller. Hvis uttrykket har flere sifre til venstre for desimalskilletegnet enn antallet nuller i format-koden, vises tilleggssifrene uten formatering.

Desimaler i uttrykket avrundes i henhold til antallet nuller som vises etter desimalskilletegnet i format-koden.

#

Hvis uttrykk inneholder et siffer ved posisjonen til # plassholderen i koden format, vises sifferet, ellers vises ingenting på denne posisjonen.

Dette symbolet fungerer som 0, bortsett fra at innledende eller etterfølgende nuller ikke vises hvis det er flere # tegn i format-koden enn sifre i uttrykket. Bare de relevante sifrene i uttrykket vises.

. (period)

Desimalplassholderen bestemmer antall desimalplasser til venstre og høyre for desimalskilletegnet.

Hvis format-koden inneholder bare # plassholdere til venstre for dette symbolet, begynner tall mindre enn 1 med et desimalskilletegn. For alltid å vise en foranstående null med brøktall, bruk 0 som plassholder for det første sifferet til venstre for desimalskilletegn.

Bruken av et punktum som tusen- og desimalskilletegn er avhengig av den regionale innstillingen. Når du skriver inn et tall direkte i Grunnleggende kildekode, bruk alltid et punktum som desimalskilletegn. Det faktiske tegnet som vises som desimalskilletegn avhenger av tallformatet i systeminnstillingene.

%

Multipliserer uttrykketmed 100 og setter inn prosenttegnet (%) der uttrykket vises i format-koden.

E- E+ e- e+

Hvis format-koden inneholder minst én siffer plassholder (0 eller #) til høyre for symbolet E-, E+, e- eller e+, formateres uttrykket i det vitenskapelige eller eksponentielle formatet. Bokstaven E eller e settes inn mellom tallet og eksponenten. Antallet plassholdere for sifre til høyre for symbolet bestemmer antall sifre i eksponenten.

Hvis eksponenten er negativ, vises et minustegn rett foran en eksponent med E-, E+, e-, e+. Hvis eksponenten er positiv, vises et plusstegn kun foran eksponenter med E+ eller e+.

- + $ ( ) space

: Et pluss (+), minus (-), dollar ($), mellomrom eller parentes angitt direkte i format-koden, vises som et bokstavelig tegn.

\

For å vise andre tegn enn de som er oppført her, må du ha en omvendt skråstrek (\), eller sette den i anførselstegn (" ").

Omvendt skråstrek viser neste tegn i format-koden.

Tegn i format-koden som har en spesiell betydning kan bare vises som bokstavelige tegn hvis de innledes med en omvendt skråstrek. Selve omvendt skråstrek vises ikke, med mindre du skriver inn en dobbel skråstrek (\\) i formatkoden.

Tegn som må innledes med en omvendt skråstrek i formatkoden for å bli vist som bokstavtegn, er dato- og tidsformateringstegn (a, c, d, h, m, n, p, q, s, t, w , y, /, :), numeriske formateringstegn (#, 0, %, E, e, komma, punktum) og strengformaterende tegn (@, &, <, >, !).


Predefinerte formater

Du kan også bruke følgende forhåndsdefinerte tallformater. Bortsett fra "Generelt tall", returnerer alle de forhåndsdefinerte formatkodene tallet som et desimaltall med to desimaler.

Hvis du bruker forhåndsdefinerte formater, må navnet på formatet være omgitt av anførselstegn.

Kode

Beskrivelse

"<"

Konverter uttrykk til små bokstaver

">"

Konverter uttrykk til store bokstaver.

"c" or "General Date"

Returnerer det numeriske uttrykket i kort datoformat, eventuelt med "H:MM:SS AM/PM". Hvis uttrykk er en streng, returnerer strengen.

"n"

Returnerer minuttet for det numeriske uttrykket, med 1 eller 2 sifre.

"nn"

Returnerer minuttet av det numeriske uttrykket med to sifre.

"w"

Returnerer ukedagen for det numeriske uttrykket. 1 er søndag og 7 er lørdag.

"General Number"

Returnerer det numeriske uttrykket med 12 sifre (0.############).

"Currency"

Returnerer det numeriske uttrykket i valutaen til lokaliteten.

"Fixed"

Returnerer det numeriske uttrykket med 2 desimaler (0,00).

"Standard"

Returnerer det numeriske uttrykket med 2 desimaler (0,00).

"Percent"

Returnerer det numeriske uttrykket som prosentverdi (0,00 %).

"Scientific"

Returnerer det numeriske uttrykket i vitenskapelig notasjon (#.00E+00);

"Yes/No"

Returnerer "Ja" hvis det numeriske uttrykket ikke er lik null, "Nei" ellers. "Ja" og "Nei" er lokalisert.

"True/False"

Returnerer "Sant" hvis det numeriske uttrykket ikke er lik null, "Usant" ellers. "Sant" og "Usant" er lokalisert.

"On/Off"

Returnerer "På" hvis det numeriske uttrykket ikke er lik null, "Av" ellers. "På" og "Av" er lokalisert.

"Long Date" or "dddddd"

Returnerer det numeriske uttrykket i systemlangt datoformat, og avhenger av lokale innstillinger.

"Medium Date"

Returnerer det numeriske uttrykket i datoformatet DD-MMM-YY, og avhenger av loke innstillinger.

"Short Date" or "ddddd"

Returnerer det numeriske uttrykket i systemets korte datoformat, og avhenger av lokale innstillinger.

"Long Time" or "ttttt"

Returnerer det numeriske uttrykket i systemlangtidsformat, og avhenger av lokale innstillinger ("H:MM:SS AM/PM").

"Medium Time"

Returnerer det numeriske uttrykket i systemmediumtidsformat, og avhenger av lokale innstillinger (TT:MM AM/PM)

"Short Time"

Returnerer det numeriske uttrykket i systemkorttidsformat, og avhenger av lokale innstillinger (TT:MM).


Feilkoder

5 Ugyldig prosedyreoppkall

Eksempel:


Sub ExampleFormat
    MsgBox Format(6328.2, "##,##0.00")
    ' bruk alltid et punktum som desimalskilletegn når du skriver inn tall i grunnleggende kildekode.
    ' viser for eksempel 6,328,20 på engelsk språk, 6,328,20 på tysk.
msgbox Format("ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890", "<") ' returnerer abcdefghijklmnopqrstuvwxyz1234567890, tallene påvirkes ikke.
msgbox Format("abcdefghijklmnopqrstuvwxyz1234567890", ">") ' returnerer ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890, tall påvirke s ikke.
msgBox Format(12345.6,"c") ' returnerer tallet i datoformat som 18/10/33 14:24:00 på tysk.
msgBox Format(12345.6,"Generell dato") ' Samme som "c".
msgbox format(12345.004,"n") ' returnerer 5
msgbox format(12345.004,"nn") ' returnerer 05
msgbox format(12345.6,"w") ' returnerer 4 (onsdag).
msgbox format(log(123),"Generelt nummer") ' returnerer 4,812184355372 i på tysk
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,"Ja/Nei") ' returnerer lokalisert "Ja"
msgbox format(0,"Ja/Nei") ' returnerer lokalisert "Nei"
msgbox format(-1,"Sann/Usann") ' returnerer lokalisert "Sann"
msgbox format(123,"På/Av") ' returnerer lokalisert "På"
msgbox format(45756.73,"Long Date") ' returnerer onsdag 9. april 2025 i på ditt språk
End Sub

Supporter oss!