Format-funktion

Konverterer et numerisk udtryk for en streng, og derefter formaterer den efter det format, du angiver.

Syntaks:


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

Parametre:

udtryk: Numerisk udtryk, som du vil konvertere til en formateret streng.

format: Streng som angiver formatkoden for tallet. Hvis format er udeladt, fungerer Format-funktionen lige som LibreOffice Basic Str()-funktionen.

Returtype

Tekststreng.

Formateringskoder

I BASIC kan en format-kode inddeles i tre dele, adskilt med semikoloner. Den første del definerer formatet for positive værdier, den anden del for negative værdier, og den tredje del for nul. Hvis du kun specificerer én format-kode, bliver den brugt på alle tal.

Lokalitetsindstillingerne styrer formatering af tal, datoer og valuta i LibreOffice Basic. Du kan vælge indstillingerne i ▸ Sprog og lokalitetsindstillinger ▸ Generelt. I Basic formatkoder bruges altid punktum (.) som pladsholder for decimaltegnet fra dine lokalitetsindstillinger. Punktum bliver erstattet med det aktuelle decimaltegn.

Det samme gælder lokalitetsindstillingerne for dato-, klokkeslæt- og valutaformater. Basic-formatkode vil blive fortolket og vist ifølge dine lokalitetsindstillinger.

Følgende liste beskriver de koder, du kan bruge til at formatere et numerisk udtryk:

Kode

Beskrivelse

0

Hvis udtryk har et ciffer på positionen for 0'et i format-koden, så vises cifferet, ellers vises et nul.

Hvis udtryk har færre cifre end antallet af nuller i koden format, (på den ene eller anden side af decimalskilletegnet), vises foran- eller efterstillede nuller. Hvis udtryk har flere cifre til venstre for decimalskilletegnet end antallet af nuller i koden format, vises yderligere cifre uden formatering.

Decimalpladser i udtryk afrundes efter antallet af nuller, der ses efter decimalskilletegnet i koden format.

#

Hvis udtryk indeholder et ciffer på positionen for pladsholderen # i format-koden, så vises cifferet, ellers vises ingenting på denne position.

Dette symbol virker ligesom 0, bortset fra, at foran- eller efterstillede nuller ikke vises, hvis der er flere #-tegn i format-koden end tegn i udtryk. Kun de relevante cifre i udtryk vises.

. (period)

Den decimale pladsholder bestemmer antallet af decimalpladser til venstre og højre for decimalskilletegnet.

Hvis koden format kun indeholder #-pladsholdere til venstre for dette symbol, begynder tal mindre en 1 med et decimalskilletegn. For altid at få vist et foranstillet nul ved brøktal bruger du 0 som en pladsholder for det første ciffer til venstre for decimalskilletegnet.

Brug af et punktum som et tusinde- og decimaltegn afhænger af regionsindstillingen. Brug altid et punktum som decimaltegn, når du indtaster et tal direkte i Basic-kildekode. Det specifikke tegn, der bliver vist som decimaltegn, afhænger af talformatet i dine systemindstillinger.

%

Multiplicerer udtryk med 100 og indsætter procenttegnet (%) hvor udtryk vises i format-koden.

E- E+ e- e+

Hvis format-koden indeholder mindst én ciffer-pladsholder (0 eller #) til højre for symbolet E-, E+, e- eller e+, så bliver udtryk formateret i videnskabeligt eller eksponentielt format. Bogstavet E eller e bliver indsat mellem tallet og eksponenten. Antallet af pladsholdere for cifre til højre for symbolet bestemmer antallet af decimaler i eksponenten.

Hvis eksponenten er negativ, bliver et minustegn vist umiddelbart før en eksponent med E-, E+, e-, e+. Hvis eksponenten er positiv, bliver et plustegn kun vist før eksponenter med E+ eller e+.

- + $ ( ) space

Tegnene plus (+), minus (-), dollar ($), mellemrum eller parenteser, som er skrevet direkte ind iformat-koden, bliver vist som de står.

\

For at vise andre tegn end de der er opført her, skal du indlede det med en omvendt skråstreg (\), eller omgive det med anførselstegn (" ").

Den omvendte skråstreg viser det næste tegn i format-koden.

Tegn i format-koden, der har en speciel betydning, kan kun vises som bogstavelige tegn, hvis de følger en omvendt skråstreg. Skråstregen selv vises ikke, med mindre du indtaster en dobbelt omvendt skråstreg (\\) i formatkoden.

De tegn, der skal have foranstillet en omvendt skråstreg i formatkoden for at blive vist som bogstavelige tegn, er: Dato- og tidsformateringstegn (a, c, d, h, m, n, p, q, s, t, w, y, /, :), numeriske formateringstegn (#, 0, %, E, e, komma, punktum) og strengformateringstegn (@, &, <, >, !).


Forhåndsdefinerede formater

Du kan også bruge følgende foruddefinerede talformater. Bortset fra "Generelt tal", returnerer alle de foruddefinerede formatkoder tallet som et decimaltal med to decimalpladser.

Hvis du bruger forud-definerede formater, skal navnet på formatet være omgivet af anførselstegn.

Kode

Beskrivelse

"<"

Konverterer udtryk til små bogstaver

">"

Konverterer udtryk til store bogstaver.

"c" or "General Date"

Returnerer det numeriske udtryk i kort datoformat, eventuelt med "T:MM:SS AM/PM". Hvis udtryk er en streng, så returneres strengen.

"n"

Returnerer minuttet for det numeriske udtryk, med 1 eller 2 cifre.

"nn"

Returnerer minuttet for det numeriske udtryk med to cifre.

"w"

Returnerer ugedagen for det numeriske udtryk. 1 er søndag og 7 er lørdag.

"General Number"

Returnerer det numeriske udtryk med 12 cifre (0.############).

"Currency"

Returnerer det numeriske udtryk i valutaen fra lokalitetsindstillingerne.

"Fixed"

Returnerer det numeriske udtryk med 2 decimaler (0,00).

"Standard"

Returnerer det numeriske udtryk med tusindtalsskilletegn og 2 decimaler (@0,00).

"Percent"

Returnerer det numeriske udtryk som procentværdi (0,00%).

"Scientific"

Returner det numeriske udtryk i videnskabelig notation (#,00E+00).

"Yes/No"

Returnerer "Ja" hvis det numeriske udtryk ikke er lig med nu, "Nej" ellers. "Ja" og "Nej" følger lokalitetsindstillingerne.

"True/False"

Returnerer "Sand" hvis det numeriske udtryk ikke er lig med nul, "Falsk" ellers. "Sand" og "Falsk" følger lokalitetsindstillingerne.

"On/Off"

Returnerer "Til" hvis det numeriske udtryk ikke er lig med 0, "Fra" ellers. "Til" og "Fra" følger lokalitetsindstillingerne.

"Long Date" or "dddddd"

Returnerer det numeriske udtryk i systemets lange datoformat (f.eks. "lørdag 1. marts 2025"), og afhænger af lokalitetsindstillingerne.

"Medium Date"

Returnerer det numeriske udtryk i datoformatet DD-MMM-ÅÅ (f.eks. 01-maj-25), og afhænger af lokalitetsindstillingerne.

"Short Date" or "ddddd"

Returnerer det numeriske udtryk i systemets korte datoformat (f.eks. "01-03-25") og afhænger af lokalitetsindstillingerne.

"Long Time" or "ttttt"

Returnerer det numeriske udtryk i systemets lange tidsformat og afhænger af lokalitetsindstillingerne ("T:MM:SS AM/PM").

"Medium Time"

Returnerer det numeriske udtryk i systemets mellemlange tidsformat og afhænger af lokalitetsindstillingerne ("TT:MM AM/PM").

"Short Time"

Returnerer det numeriske udtryk i systemets korte tidsformat og afhænger af lokalitetsindstillingerne ("TT:MM").


Fejlkoder:

5 Ugyldigt Procedurekald

Eksempel:


Sub ExampleFormat
    MsgBox Format(6328.2, "##,##0.00")
    REM brug altid et punktum som decimaltegn, når du indtaster tal i Basic-kildekode.
    REM viser for eksempel 6,328.20 på engelsk, 6.328,20 på dansk.
msgbox Format("ABCDEFGHIJKLMNOPQRSTUVWXYZÆØÅ1234567890", "<") ' returnerer abcdefghijklmnopqrstuvwxyzæøå1234567890, hvor tal ikke er påvirkes.
msgbox Format("abcdefghijklmnopqrstuvwxyzæøå1234567890", ">") ' returnerer ABCDEFGHIJKLMNOPQRSTUVWXYZÆØÅ1234567890, hvor tal ikke påvirkes.
msgBox Format(12345.6,"c") ' returnerer tallet i datoformat som 18-10-33 2:24:00 PM med dansk lokalitetsindstilling.
msgBox Format(12345.6,"General Date") ' 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),"General Number") ' returnerer 4,812184355372 med dansk lokalitetsindstilling (hvor decimaltegnet er et komma)
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") ' returnerer "Ja" med dansk lokalitetsindstilling
msgbox format(0,"Yes/No") ' returnerer "Nej" med dansk lokalitetsindstilling
msgbox format(-1,"True/False") ' returnerer "Sand" med dansk lokalitetsindtilling
msgbox format(123,"On/Off") ' returnerer "Til" med dansk lokalitetsindstilling
msgbox format(45756.73,"Long Date") ' returnerer "onsdag 9. april 2025" med dansk lokalitetsindstilling
End Sub

Støt os venligst!