IBM Lotus Symphony
|
Pozwala przekształcić liczbę w łańcuch i nadać jej żądany format.
Format (Liczba [, Format As String])
Łańcuch
Liczba: Wyrażenie liczbowe do przekształcenia w sformatowany łańcuch.
Format: Łańcuch określający kod formatu liczby. Jeśli parametr Format zostanie pominięty, funkcja Format działa tak jak funkcja Str.
Poniższa lista zawiera opis kodów, które mogą być używane do formatowania liczb.
0: Jeśli Liczba zawiera cyfrę na pozycji znaku 0 w kodzie formatu, cyfra ta zostanie wyświetlona. W przeciwnym przypadku wyświetlone zostanie zero.
Jeśli Liczba zawiera mniej cyfr niż kod formatu zer (po obu stronach separatora dziesiętnego), wyświetlane będą odpowiednio początkowe lub końcowe zera. Jeśli liczba ma więcej cyfr po lewej stronie separatora dziesiętnego niż kod formatu zer, dodatkowe cyfry zostaną wyświetlone bez formatowania.
Miejsca dziesiętne liczby są zaokrąglane zgodnie z liczbą zer po separatorze dziesiętnym w kodzie Format.
#: Jeśli Liczba ma cyfrę na pozycji obiektu zastępczego # w kodzie formatu, cyfra ta zostanie wyświetlona. W przeciwnym przypadku nic nie będzie wyświetlane na tej pozycji.
Ten symbol działa podobnie do znaku 0, z tym że początkowe i końcowe zera nie są wyświetlane, jeśli w kodzie formatu jest więcej znaków # niż cyfr w liczbie. Wyświetlane są tylko cyfry rzeczywiście składające się na liczbę.
.: Dziesiętny obiekt zastępczy określa liczbę miejsc dziesiętnych po lewej i prawej stronie separatora dziesiętnego.
Jeśli kod formatu zawiera tylko obiekty zastępcze # po lewej stronie tego symbolu, liczby mniejsze od 1 będą zaczynały się od separatora dziesiętnego. Aby zawsze przed ułamkami wyświetlane było zero, należy użyć obiektu zastępczego 0 dla pierwszej cyfry po lewej stronie separatora dziesiętnego.
%: Powoduje przemnożenie liczby przez 100 i wstawienie znaku procentu (%) w miejscu, w którym znak ten został umieszczony w kodzie formatu.
E- E+ e- e+ : Jeśli kod formatu zawiera przynajmniej jeden obiekt zastępczy cyfry (0 lub #) po prawej stronie symbolu E-, E+, e-, lub e+, liczba będzie formatowana w naukowym lub wykładniczym formacie. Litera E lub e jest wstawiana między liczbę a wykładnik. Liczba obiektów zastępczych cyfr po prawej stronie tego symbolu określa liczbę cyfr w wykładniku.
Jeśli wykładnik jest ujemny, znak minus jest wyświetlany bezpośrednio przed wykładnikiem z E-, E+, e-, e+. Jeśli wykładnik jest dodatni, znak plus jest wyświetlany tylko przed wykładnikami z E+ lub e+.
Separator tysięcy jest wyświetlany, jeśli kod formatu zawiera ten separator między obiektami zastępczymi cyfr (0 lub #).
Użycie kropki w charakterze separatora dziesiętnego lub tysięcy zależy od ustawień regionalnych. Wprowadzając liczbę bezpośrednio w kodzie źródłowym Basic, jako separatora dziesiętnego należy zawsze używać kropki. Znak wyświetlany jako separator dziesiętny zależy od formatu liczb w ustawieniach systemowych.
- + $ ( ) odstęp: Plus (+), minus (-), dolar ($), odstęp lub nawias wprowadzony bezpośrednio w kodzie formatu jest wyświetlany jako znak.
Aby wyświetlić inne znaki niż wymienione, należy poprzedzić je odwrotnym ukośnikiem (\) lub zawrzeć w cudzysłowie (" ").
\: Odwrotny ukośnik powoduje wyświetlenie następnego znaku w kodzie formatu.
Znaki, które mają specjalne znaczenie w kodzie formatu, mogą być wyświetlane jako znaki, jeśli zostaną poprzedzone odwrotnym ukośnikiem. Sam odwrotny ukośnik nie jest wyświetlany, o ile w kodzie formatu nie zostanie wprowadzony podwójny ukośnik (\\).
Znaki, które muszą zostać poprzedzone ukośnikiem odwrotnym w kodzie formatu w celu wyświetlenia, to znaki formatowania daty i godziny (a, c, d, h, m, n, p, q, s, t, w, y, /, :), znaki formatowania liczb (#, 0, %, E, e, przecinek, kropka) i znaki formatowania łańcuchów (@, &, <, >, !).
Dostępne są również niżej opisane predefiniowane formaty liczb. Wszystkie predefiniowane formaty z wyjątkiem formatu "General Number" powodują zwrócenie liczby z dwoma miejscami dziesiętnymi.
Aby użyć predefiniowanego formatu, należy wprowadzić jego nazwę w cudzysłowie.
General Number: Liczby są wyświetlane dokładnie tak, jak zostały wprowadzone.
Currency: Powoduje wstawienie symbolu waluty obok liczby. Liczby ujemne umieszczane są w nawiasie.
Fixed: Przed separatorem dziesiętnym wyświetlana jest co najmniej jedna cyfra.
Standard: Liczby wyświetlane są z separatorem tysięcy.
Percent: Liczba mnożona jest przez 100 i dodawany jest do niej znak procentu.
Scientific: Liczby są wyświetlane w formacie naukowym (np. 1,00E+03 dla liczby 1000).
Kod formatu można podzielić na trzy sekcje oddzielone średnikami. Pierwsza część definiuje format wartości dodatnich, druga część - wartości ujemnych, a trzecia - wartości zero. Jeśli określony zostanie tylko jeden kod formatu, będzie on mieć zastosowanie do wszystkich liczb.
Ustawienia narodowe używane do sterowania formatowaniem liczb, dat i walut w środowisku języka Basic programu Lotus® Symphony™ można określić, wybierając opcję Narzędzia - Opcje - Ustawienia językowe - Języki. W kodach w formacie języka Basic separator dziesiętny (.) jest zawsze używany jako obiekt zastępczy dla separatora dziesiętnego zdefiniowanego w ustawieniach narodowych i zastępowany odpowiednim znakiem.
To samo dotyczy ustawień narodowych dla formatów daty, godziny i waluty. Kod w formacie języka Basic będzie interpretowany i wyświetlany zgodnie z ustawieniami narodowymi.
Sub Przyklad_Format
MsgBox Format(6328.2, "##,##0.00")
REM Wprowadzając liczby w kodzie źródłowym Basic, jako separatora dziesiętnego należy zawsze używać kropki.
REM Powoduje na przykład wyświetlenie wartości 6,328.20 dla angielskich ustawień narodowych lub liczby 6.328,20 dla niemieckich ustawień narodowych.
End Sub