IBM Lotus Symphony


Funktionen Format [Runtime]

Konverterer et tal til en streng og formaterer derefter strengen i overensstemmelse med det format, du angiver.

Syntaks:

Format (Tal [, Format As String])

Returværdi:

String

Parametre:

Tal: Et numerisk udtryk, der skal konverteres til en formateret streng.

Format: En streng, der angiver formatkoden til tallet. Hvis Format udelades, fungerer funktionen Format ligesom funktionen Str.

Formatkoder

Herunder findes en oversigt over de koder, du kan bruge til at formatere et tal:

0: Hvis Tal har et ciffer på position 0 i formatkoden, vises cifferet. Ellers vises nul (0).

Hvis Tal har færre cifre, end der er nuller i formatkoden (på hver side af decimaltegnet), indsættes mellemrum før eller efter tallet. Hvis tallet har flere cifre til venstre for decimaltegnet, end der er nuller i formatkoden, vises de ekstra cifre uden formatering.

Antallet af decimaler i tallet afrundes til det antal nuller, der står efter decimaltegnet i formatkoden.

#: Hvis Tal indeholder et ciffer på positionen for pladsholderen # i formatkoden Format, vises cifferet, ellers vises ingenting på denne position.

Symbolet fungerer på samme måde som 0 med undtagelse af, at der ikke indsættes nuller før eller efter tallet, hvis der er flere #-tegn i formatkoden, end der er cifre i tallet. Kun tallets relevante cifre vises.

.: Fungerer som pladsholder for decimaltegnet og adskiller cifrene til venstre og til højre for decimaltegnet.

Hvis formatkoden kun indeholder #-pladsholdere til venstre for dette symbol, begynder tal under 1 med decimaltegnet. Brug 0 som pladsholder for første ciffer til venstre for decimaltegnet, hvis der skal indsættes nul før decimaltegnet ved tal, der er mindre end 1.

%: Multiplicerer tallet med 100 og indsætter procenttegnet (%) det sted, hvor symbolet står i formatkoden.

E- E+ e- e+ : Hvis formatkoden indeholder mindst én cifferpladsholder (0 eller #) til højre for symbolet E-, E+, e- eller e+, formateres tallet i eksponentielt format. Bogstavet E eller e indsættes mellem tallet og eksponenten. Antallet af cifferpladsholdere til højre for symbolet bestemmer antallet af cifre i eksponenten.

Hvis eksponenten er negativ, indsætter E-, E+, e- eller e+ et minustegn lige før eksponenten. Hvis eksponenten er positiv, indsættes kun et plustegn foran eksponenten ved E+ eller e+.

Tusindtalsseparatoren vises, hvis formatkoden indeholder separatoren mellem cifferpladsholdere (0 eller #).

Brugen af punktum eller komma som tusindtalsseparator og decimaltegn afhænger af systemets landestandard. Du skal altid bruge et punktum som decimaltegn, når du skriver et tal direkte i Basic-kildekode. Det tegn, der vises som decimaltegn, afhænger af talformatet i systemindstillingerne.

- + $ ( ) mellemrum: Plustegn (+), minustegn (-), dollartegn ($), mellemrum eller parenteser i formatkoden vises som selve tegnene.

Hvis du vil have vist andre tegn end disse, skal du indsætte en omvendt skråstreg (\) foran tegnet eller sætte det i anførselstegn (" ").

\ : En omvendt skråstreg bevirker, at det næste tegn i formatkoden vises.

De tegn i formatkoden, der har en særlig betydning, kan kun vises som selve tegnene, hvis de står efter en omvendt skråstreg. Selve den omvendte skråstreg vises ikke, medmindre du skriver to omvendte skråstreger (\\) i formatkoden.

Følgende tegn skal stå efter en omvendt skråstreg i formatkoden, hvis de skal vises som selve tegnene: Tegn til formatering af datoer og klokkeslæt (a, c, d, h, m, n, p, q, s, t, w, y, /, :, ), tegn til formatering af numeriske værdier (#, 0, %, E, e, komma, punktum) og tegn til formatering af strenge (@, &, <, >, !).

Du kan også benytte følgende foruddefinerede talformater. Med undtagelse af "General Number" returnerer alle de foruddefinerede formatkoder tal som decimaltal med to decimaler.

Hvis du bruger foruddefinerede formater, skal formatnavnet sættes i anførselstegn.

Foruddefineret format

General Number: Tal vises, som de angives.

Currency: Der sættes et valutasymbol, f.eks. "kr" foran tallet, og negative tal sættes i parentes.

Fixed: Der vises mindst ét ciffer foran decimaltegnet.

Standard: Tal vises med tusindtalsseparator.

Percent: Multiplicerer tallet med 100 og føjer et procenttegn til tallet.

Scientific: Tal vises i videnskabeligt (eksponentielt) format, f.eks. 1,00E+03 for 1000).

En formatkode kan inddeles i tre afsnit, der adskilles af semikolon. Det første afsnit definerer formatet for positive værdier, det andet afsnit formatet for negative værdier og det tredje afsnit for nul. Hvis du kun angiver én formatkode, gælder den for alle tal.

Du kan angive den landestandard, der bruges til at styre formatering af tal, datoer og valutaer i Lotus® Symphony™ Basic, i Værktøjer - Indstillinger - Sprogindstillinger - Sprog. I Basic-formatkoder bruges decimalpunktummet (.) altid som pladsholder for det decimaltegn, der er defineret i din landestandard, og erstattes af det tilsvarende tegn.

Det samme gælder indstillinger i landestandarden for dato-, klokkeslæts- og valutaformater. Basic-formatkoden fortolkes og vises i overensstemmelse med indstillingerne i landestandarden.

Fejlkoder

5 Ugyldigt procedurekald

Eksempel:

Sub EksempelFormat

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

REM brug altid punktum som decimaltegn, når du skriver tal i Basic-kildekode.

REM Viser 6.328,20 ved landestandarden Dansk og 6,328.20 ved landestandarden US.

End Sub


Produktfeedback | Yderligere dokumentation | Varemærker