Module
Contents
Index 🔎︎

# Format Function

Konverterar ett tal till en sträng och formaterar den sedan enligt det format som du anger.

## Syntax:

    Format (Number [, Format As String])

## Returvärde:

String

## Parametrar:

Tal: Ett numeriskt uttryck som du vill konvertera till en formaterad sträng.

Format: Sträng som anger formatbeskrivningen för talet. Om Format utelämnas fungerar funktionen Format som funktionen Str.

## Formatbeskrivningar

I den här listan beskrivs formatbeskrivningarna som du kan använda när du formaterar tal:

0: Om det i Number finns en siffra vid positionen för 0 i formatbeskrivningen visas siffran, annars visas en nolla.

Om det i uttrycket Number finns färre siffror än antalet nollor i formatbeskrivningen (oavsett sida av decimaltecknet), visas inledande eller efterföljande nollor. Om talet innehåller fler siffror till vänster om decimaltecknet än antalet nollor i formatbeskrivningen, visas de ytterligare siffrorna utan ändring.

Decimalerna i talet avrundas till det antal decimaler som motsvarar antalet nollor efter decimaltecknet i formatbeskrivningen.

#: Om det i Number finns en siffra vid positionen för platshållaren # i formatbeskrivningen visas siffran, annars visas ingenting.

Den här symbolen fungerar som 0, förutom att inledande eller efterföljande nollor inte visas om det finns fler #-tecken i formatbeskrivningen än antalet siffror i talet. Endast de siffror som är relevanta för talet visas.

.: Decimalplatshållaren bestämmer antalet decimaler till vänster och höger om decimaltecknet.

Om formatbeskrivningen bara består av #-platshållare till vänster om den här symbolen, börjar tal som är mindre än 1 med ett decimaltecken. Om du vill att bråktal alltid ska visas med en inledande nolla, använder du 0 som platshållare för den första siffran till vänster om decimaltecknet.

%: Multiplicerar talet med 100 och infogar procentsymbolen (%) där talet visas i formatbeskrivningen.

E- E+ e- e+ : Om formatbeskrivningen innehåller minst en sifferplatshållare (0 eller #) till höger om symbolen E-, E+, e- eller e+, formateras talet i potensform eller exponentiellt format. Bokstaven E eller e infogas mellan talet och exponenten. Antalet platshållare för siffror till höger om symbolen bestämmer antalet siffror i exponenten.

Om exponenten är negativ visas ett minustecken direkt före en exponent med E-, E+, e-, e+. Om exponenten är positiv visas bara ett plustecken före exponenten med E+ eller e+.

Tusentalsavgränsaren visas om formatbeskrivningen innehåller avgränsaren innesluten av talplatshållare (0 eller #).

Om punkt används som decimaltecken och tusentalsavgränsare beror på de nationella inställningarna. När du anger ett tal direkt i Basic-källkoden måste du däremot använda en punkt som decimalavgränsare. Vilket tecken som visas som decimaltecken beror på talformatet i systeminställningarna.

- + $ ( ) space: Plustecken (+), minustecken (-), dollartecken ($), blanksteg eller parenteser som anges direkt i formatbeskrivningen visas som konstanta tecken.

Om du vill visa andra tecken än de som listas här måste de föregås av ett omvänt snedstreck (\) eller inneslutas av citattecken (" ").

\ : Med omvänt snedstreck visas nästa tecken i formatbeskrivningen.

Tecken i formatbeskrivningen som har en speciell betydelse kan bara visas som konstanta tecken om de föregås av ett omvänt snedstreck. Det omvända snedstrecket visas inte om du inte anger dubbla omvända snedstreck (\\) i formatbeskrivningen.

De tecken som bara visas om de föregås av ett omvänt snedstreck i formatbeskrivningen är tecken för datum- och tidsformat (a, c, d, h, m, n, p, q, s, t, w, y, /, :), tecken för numeriska format (#, 0, %, E, e, komma, punkt) och tecken för strängformat (@, &, <, >, !).

Du kan även använda följande fördefinierade talformat: Med undantag för "Alla" returnerar alla fördefinierade formatbeskrivningar talet som ett decimaltal med två decimaler.

Om du använder fördefinierade format måste du ange namnet inom citattecken.

## Fördefinierade format

General Number: Talen visas så som de har matats in.

Currency: Infogar ett dollartecken framför talet och sätter negativa tal inom parentes.

Fixed: Visar minst en siffra framför decimaltecknet.

Standard: Visar tal med tusentalsavgränsare.

Percent: Multiplicerar talet med 100 och lägger till ett procenttecken efter talet.

Vetenskap: Visar tal i potensformat (till exempel 1,00E+03 motsvarande 1000).

En formatbeskrivning kan delas i tre delar separerade med semikolon. Den första delen definierar formatet för positiva värden, den andra delen formatet för negativa värden och den tredje delen formatet för noll. Om du bara anger en formatbeskrivning gäller den för alla tal.

Du kan ange en språkvariant för att styra konverteringen av tal, datum och valutor i LibreOffice Basic under LibreOffice – Inställningar Verktyg – Alternativ
– Språkinställningar – Språk. I Basic-talformat används alltid en decimalpunkt (.) som platshållare för det decimaltecken som gäller för den aktuella språkvarianten. Decimalpunkten kommer att ersättas med motsvarande decimaltecken.

Detta gäller även språkinställningar för datum-, tids- och valutaformat. Basic-formatet kommer att tolkas och visas på det sätt som definierats i språkinställningarna.

## Error codes:

5 Felaktigt proceduranrop

## Exempel:

    Sub ExampleFormat

        MsgBox Format(6328.2, "##,##0.00")

        ' använd alltid en punkt som decimalavgränsare när du skriver tal i Basic-källkod.

        ' visar till exempel 6,328.20 i engelska språkvarianter och 6 328,20 i svenska språkvarianter.

    End Sub

Närliggande ämnen

Number format codes