IBM Lotus Symphony


Funkcia Format [Runtime]

Konvertuje číslo na reťazec a potom ho formátuje podľa zadaného formátu.

Syntax:

Format (číslo [, Format ako typ String])

Návratová hodnota:

Reťazec

Parametre:

Číslo: numerický výraz, ktorý chcete konvertovať na formátovaný reťazec.

Format: reťazec, ktorý špecifikuje kód formátu čísla. Ak sa Format vynechá, funkcia Format funguje ako funkcia Str.

Formátovacie kódy

Nasledujúci zoznam popisuje kódy, ktoré môžete použiť na formátovanie čísla:

0: ak má číslo číslicu na pozícii 0 formátovacieho kódu, táto číslica sa zobrazí, inak sa zobrazí nula.

Ak má číslo menej číslic ako je počet núl vo formátovacom kóde (na oboch stranách desatinnej čiarky), zobrazia sa vodiace alebo koncové nuly. Ak má číslo viac číslic naľavo od desatinného oddeľovača ako je počet núl vo formátovacom kóde, ďalšie číslice sa zobrazia ako neformátované.

Desatinné miesta v čísle sa zaokrúhľujú podľa počtu núl, ktoré sa objavia za desatinným oddeľovačom v kóde funkcie Format .

#: ak číslo obsahuje číslicu na pozícii kontajnera PH # v kóde funkcie Format, číslica sa zobrazí, inak sa na tejto pozícii nezobrazí nič.

Tento symbol funguje ako 0 až na to, že vodiace alebo koncové nuly sa nezobrazujú, ak je vo formátovacom kóde viac znakov # ako je počet miest čísla. Zobrazujú sa iba relevantné miesta čísla.

.: desatinný kontajner PH určuje počet desiatkových miest naľavo a napravo od desatinného oddeľovača.

Ak obsahuje formátovací kód iba kontajnery PH # naľavo od tohto symbolu, čísla menšie ako 1 sa začínajú desatinným oddeľovačom. Aby sa vždy zobrazovala vodiaca nula v desatinných číslach, používajte znak 0 ako kontajner PH prvej číslice naľavo od desatinného oddeľovača.

%: násobí dané číslo číslom 100 a vkladá znak percenta (%) tam, kde sa číslo objavuje vo formátovacom kóde.

E- E+ e- e+ : ak formátovací kód obsahuje aspoň jeden kontajner PH číslice (0 alebo #) napravo od symbolu E-, E+, e- alebo e+, číslo sa formátuje v matematickom alebo exponenciálnom formáte. Písmeno E alebo e sa vkladá medzi číslo a jeho exponent. Počet výplnkov číslic napravo od symbolu, určuje počet číslic exponentu.

Ak je exponent záporný, zobrazí sa mínusové znamienko bezprostredne pred exponentom s písmenami E-, E+, e-, e+. Ak je exponent kladný, plusové znamienko sa zobrazí iba pred exponentmi s písmenami E+ alebo e+.

Oddeľovací znak tisícok sa zobrazuje, ak formátovací kód obsahuje tento oddeľovač uzatvorený výplnkami číslic (0 alebo #).

Používanie bodky ako oddeľovača tisícok závisí od regionálnych nastavení. Keď priamo do zdrojového kódu Basic zadáte číslo, ako oddeľovač desatinných miest použite vždy bodku. Skutočný znak zobrazovaný ako desatinný oddeľovač závisí od formátu čísel vo nastaveniach vášho systému.

- + $ ( ) medzera: znamienko plus (+), znamienko mínus (-), znak meny dolár ($), medzera alebo hranaté zátvorky vložené priamo vo formátovacom kóde sa zobrazujú ako literál.

Na zobrazenie iných znakov ako tých, ktoré sa tu uvádzajú, musíte pred ne uviesť obrátená lomka (\) alebo ich uzavrieť do úvodzoviek (" ").

\ : obrátená lomka zobrazuje ďalší znak vo formátovacom kóde.

Znaky vo formátovacom kóde, ktoré majú špeciálny význam sa môžu zobrazovať ako literály iba vtedy, ak je pred nimi obrátená lomka. Samotné obrátená lomka sa nezobrazuje, ak nezadáte vo formátovacom kóde dvojité obrátená lomka (\\).

Znaky, pred ktorými sa musí uvádzať obrátená lomka vo formátovacom kóde, aby sa zobrazili ako literál sú znaky formátovania dátumu a času (a, c, d, h, m, n, p, q, s, t, w, y, /, :, ), znaky formátovania čísel (#, 0, %, E, e, čiarka, bodka) a znaky formátovania reťazcov (@, &, <, >, !).

Môžete tiež použiť nasledujúce predefinované formáty čísel. Okrem formátu "Všeobecný", všetky predefinované formátovacie kódy vrátia číslo ako desatinné číslo s dvomi desatinnými miestami.

Ak používate preddefinované formáty, názov formátu musí byť uzavretý do úvodzoviek.

Predefinovaný formát

Všeobecný: čísla sa zobrazujú tak, ako sa zadávajú.

Mena: vkladá znak dolára pred číslo a uzatvára záporné čísla do hranatých zátvoriek.

Pevný: zobrazuje aspoň jednu číslicu pre desatinným oddeľovačom.

Štandardný: zobrazuje čísla s oddeľovačom tisícok.

Percento: násobí dané číslo číslom 100 a pridáva k nemu znak percenta.

Vedecký: Zobrazí čísla vo vedeckom formáte (napríklad 1.00E+03 pre 1000).

Formátovací kód sa môže deliť na tri časti oddelené bodkočiarkami. Prvá časť definuje formát kladných hodnôt, druhá časť formát záporných hodnôt a tretia časť formát pre nulu. Ak zadáte iba jeden formátovací kód, platí pre všetky čísla.

V Nástroje - Voľby - Jazykové nastavenia - Jazyky môžete nastaviť miestne nastavenie, ktoré sa používa pre riadenie formátovania čísel, dátumov a peňažných mien v Lotus® Symphony™ Basic. Vo formátovacích kódoch jazyka Basic sa vždy používa desatinná bodka (.) ako kontajner PH desatinného oddeľovača definovaného vo vašich lokálnych nastaveniach a bude nahradená príslušným znakom.

To isté platí pre lokálne nastavenia formátov dátumu, času a znaku meny. Formátovací kód jazyka Basic sa bude interpretovať a zobrazovať podľa vašich lokálnych nastavení.

Chybové kódy

5 Neplatné volanie procedúry

Príklad:

Sub Príklad_Format

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

REM keď zadávate čísla do zdrojového kódu Basic, vždy ako oddeľovač desatinných miest používajte bodku.

REM zobrazí 6,328.20 v anglickom miestnom nastavení a 6.328,20 v nemeckom miestnom nastavení.

End Sub


Spätná väzba na produkt | Ďalšia dokumentácia | Ochranné známky