Vsebina

# Funkcija Format

Pretvori številski izraz v niz in ga potem oblikuje v skladu z obliko, ki jo navedete.

### Skladnja:

    Format(izraz [, oblika As String]) As String

### Parametri:

Izraz: numerični izraz, ki ga želite pretvoriti v oblikovan niz.

Oblika: Niz, ki določa kodo za oblikovanje števila. Če parametra format ne navedete, bo funkcija Format dala isti rezultat kot funkcija LibreOffice Basic Str().

### Vrnjena vrsta:

Besedilni niz.

## Kode za oblikovanje

Kodo za oblikovanje format je mogoče razdeliti v tri odseke, ki so med seboj ločeni z vejicami. Prvi del definira obliko za pozitivna števila, drugi del za negativna števila, tretji del pa za nič. Če navedete samo eno kodo za obliko format, se jo bo uporabilo za vsa števila.

Področne nastavitve, ki se uporabljajo za obliko števil, datumov in valute v LibreOffice Basicu, lahko nastavite v LibreOffice – Nastavitve Orodja – Možnosti – Jeziki in področne nastavitve – Splošno. V kodah zapisov Basica je decimalna pika (.) vedno uporabljena kot ograda za desetiško ločilo, določeno z vašo področno nastavitvijo in bo kasneje zamenjana z ustreznim znakom.

Enako velja za področne nastavitve oblike datuma, časa in valute. Oblika zapisa Basica bo prevedena in prikazana glede na vaše področne nastavitve.

Naslednji seznam navaja kode, ki jih lahko uporabljate za oblikovanje številskih izrazov:

Koda | Opis
--- | ---
0 | Če ima izraz števko na mestu, kjer se nahaja 0 v kodi oblika, se prikaže števka, sicer pa ničla. Če ima izraz manj mest, kot je ničel v kodi za oblikovanje oblika (na obeh straneh decimalne vejice), bo imel rezultat vodeče ali sledeče ničle. Če ima izraz na levi strani decimalnega ločila več mest, kot je ničel v kodi za oblikovanje oblika, bodo dodatne cifre izpisane neoblikovano. Decimalna mesta v izrazu se zaokrožajo v skladu s številom ničel, ki se nahajajo za decimalnim ločilom v kodi oblika.
# | Če vsebuje izraz cifro na mestu, kjer se nahaja v kodi oblikovanja oblika nahaja ograda #, se na tem mestu izpiše cifra, sicer pa nič. Ta simbol deluje tako kot 0, samo da se vodečih ali sledečih ničel ne kaže, če je v kodi za oblikovanje oblika več znakov # kot pa mest v izrazu. Prikazana so samo pomembna mesta v izrazu.
. (period) | Znak za decimalno ločilo določa število decimalnim mest levo in desno od decimalnega ločila. Če koda za oblikovanje oblika vsebuje samo znake # levo od tega simbola, se rezultat za števila, manjša od 1, začenja z decimalnim ločilom. Uporabite znak 0 za prvo mesto levo od decimalnega ločila, da bodo v tem primeru števila izpisana z vodilno ničlo. Ali se pika uporablja kot ločilo za tisoče ali za decimalke, je odvisno od področne nastavitve. Kadar vnašate število neposredno v izvorno kodo za Basic, za decimalno ločilo vedno uporabljajte piko. Kateri znak se bo dejansko uporabil, je odvisno od numeričnega oblike v sistemskih nastavitvah.
% | Pomnoži izraz s 100 in na mestu, kjer se izraz v kodi za oblikovanje oblika nahaja, vrine znak za odstotek (%).
E- E+ e- e+ | Če koda za oblikovanje format vsebuje najmanj en znak (0 or #) desno od simbola E-, E+, e-, or e+, se bo expression izpisal v znanstveni ali eksponentni obliki. Med število in eksponent se vstavi črka E oziroma e. Število znakov za mesta desno od simbola določa, koliko znakov bo imel eksponent. Če je eksponent negativen, se za E-, E+, e-, e+ znak minus izpiše neposredno pred eksponent. Če je eksponent pozitiven, se znak plus piše pred eksponente samo v primeru E+ or e+.
- + $ ( ) space | : Znaki plus (+), minus (-), dolar ($), presledek ali oklepaji, ki so neposredno vneseni v oblikovni kodi format, se prikažejo dobesedno.
\ | Če želite prikazati kake druge znake, jim morate predpisati poševnico (\), ali pa jih obdati z narekovaji (" "). Poševnica izpiše naslednji znak v kodi za oblikovanje oblika. Znake v kodi za oblikovanje oblika, ki imajo poseben pomen, je mogoče prikazati take kot so, samo če prednje zapišete poševnico. Poševnica se pri tem ne izpiše, razen če ne vpišete dvojno poševnico (\\) v kodo za oblikovanje. Če želite dobeseden izpis, moramo postaviti poševnico pred znake za oblikovanje datuma in časa (a, c, d, h, m, n, p, q, s, t, w, y, /, :) , pred znake, s katerimi se oblikujejo števila (#, 0, %, E, e, vejica, pika), in pred znake za oblikovanje nizov (@, &, <, >, !).

## Vnaprej določene oblike

Lahko uporabljate tudi naslednje vnaprej določene oblike za števila. Razen oblike »General Number« vse vrnejo vnaprej določene oblike število v obliki decimalnega števila z dvema decimalnima mestoma.

Če uporabljate vnaprej določene oblike, morate ime oblike postaviti v narekovaje.

Koda | Opis
--- | ---
"<" | Pretvori znake izraza v male črke.
">" | Pretvori znake izraza v velike črke.
"c" or "General Date" | Vrne numerični izraz v kratki datumski obliki, lahko tudi v obliki »U:MM:SS dop./pop.«. Če je izraz niz, vrne niz.
"n" | Vrne minute numeričnega izraza, z 1 ali 2 števkama.
"nn" | Vrne minute numeričnega izraza z dvema števkama.
"w" | Vrne dan tedna numeričnega izraza. 1 pomeni nedeljo, 7 je sobota.
"General Number" | Vrne numerični izraz z 12 števkami (0,############).
"Currency" | Vrne numerični izraz z valuto področnih nastavitev.
"Fixed" | Vrne numerični izraz z 2 decimalnimi mesti (0,00).
"Standard" | Vrne numerični izraz z ločili tisočic in dvema decimalnima mestoma (@0,00).
"Percent" | Vrne numerični izraz kot odstotkovno vrednost (0,00 %).
"Scientific" | Vrne numerični izraz v znanstveni notaciji (#,00E+00).
"Yes/No" | Vrne »Da«, če numerični izraz ni enak nič, sicer vrne »Ne«. Angleška »Yes« in »No« sta vrnjena v jeziku področnih nastavitev.
"True/False" | Vrne »True«, če numerični izraz ni enak nič, sicer vrne »False«. Angleška »True« in »False« sta vrnjena v jeziku področnih nastavitev.
"On/Off" | Vrne »On« (vključeno), če numerični izraz ni enak nič, sicer vrne »Off« (izključeno). Angleška »On« in »Off« sta vrnjena v jeziku področnih nastavitev.
"Long Date" or "dddddd" | Vrne numerični izraz v sistemski dolgi datumski obliki in je odvisna od področnih nastavitev.
"Medium Date" | Vrne numerični izraz v datumski obliki DD-MMM-LL in je odvisna od področnih nastavitev.
"Short Date" or "ddddd" | Vrne numerični izraz v sistemski kratki datumski obliki, ki je odvisna od področnih nastavitev.
"Long Time" or "ttttt" | Vrne numerični izraz v sistemski dolgi datumski obliki glede na področne nastavitve (»H:MM:SS AM/PM« oz. »U:MM:SS dop./pop.«).
"Medium Time" | Vrne numerični izraz v sistemski srednji datumski obliki glede na področne nastavitve (»H:MM:SS AM/PM« oz. »U:MM:SS dop./pop.«).
"Short Time" | Vrne numerični izraz v sistemski kratki datumski obliki glede na področne nastavitve (»H:MM:SS AM/PM« oz. »U:MM:SS dop./pop.«).

### Kode napak:

5 Neveljaven klic procedure

### Primer:

    Sub ExampleFormat
        MsgBox Format(6328.2, "##,##0.00")
        ' ko vnašate števila v izvorno kodo za Basic, uporabljajte vedno piko za decimalno ločilo.
        ' prikaže 6,328.20 pri angleških in 6.328,20 pri slovenskih področnih nastavitvah.
    msgbox Format("ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890", "<") ' vrne abcdefghijklmnopqrstuvwxyz1234567890, na števke ne vpliva.
    msgbox Format("abcdefghijklmnopqrstuvwxyz1234567890", ">") ' vrne ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890, na števke ne vpliva.
    msgBox Format(12345.6,"c") ' vrne število v datumski obliki kot 18.10.33 14:24:00 v nemških področnih nastavitvah.
    msgBox Format(12345.6,"General Date") ' Enako kot "c".
    msgbox format(12345,004,"n") ' vrne 5
    msgbox format(12345.004,"nn") ' vrne 05
    msgbox format(12345.6,"w") ' vrne 4 (sreda).
    msgbox format(log(123),"General Number") ' vrne 4,812184355372 v vaših področnih nastavitvah
    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") ' vrne "Da", t.j. področno prevedeni "Yes"
    msgbox format(0,"Yes/No") ' vrne "Ne", t.j. področno prevedeni "No"
    msgbox format(-1,"True/False") ' vrne področno prevedeni "True"
    msgbox format(123,"On/Off") ' vrne področno prevedeni "On"
    msgbox format(45756.73,"Long Date") ' vrne sredo, 9. april 2025 glede na vaše krajevne nastavitve
    End Sub

Podobne teme

Kode za obliko številk

Funkcije z nizi