FormatValue

Zastosowanie

Funkcja FormatValue formatuje datę albo liczbę według podanego formatu i zwraca wynik jako tekst. Wartość innego typu, np. tekst, funkcja zwraca bez zmian.

Separator dziesiętny, separator tysięcy i nazwy miesięcy zależą od ustawień językowych. Domyślnie funkcja używa ustawień językowych bieżącego użytkownika. Inne ustawienia wskażesz argumentem language.

Składnia

FormatValue(value, formatString);

FormatValue(value, formatString, language);

Argumenty

Argument	Typ	Wymagany	Opis
`value`	data, data i godzina albo liczba	Tak	Wartość do sformatowania.
`formatString`	tekst	Tak	Format, według którego wartość ma zostać sformatowana, np. `yyyy-MM-dd` dla daty albo `0,0.000` dla liczby. Dla daty wartość `utc` daje format `yyyy-MM-ddTHH:mm:sszzz`.
`language`	tekst	Nie	Kod języka, którego ustawienia zostaną użyte, np. `en` (kropka jako separator dziesiętny) albo `pl` (przecinek).

Zwracana wartość

Funkcja zwraca tekst: sformatowaną datę albo liczbę. Jeżeli wartość jest innego typu, funkcja zwraca ją bez zmian.

Przykłady

Przykład 1: data z nazwą miesiąca

Przy angielskich ustawieniach językowych wynik to „2015 Feb 13”.

FormatValue(DateTime(2015,2,13),"yyyy MMM dd");

Przykład 2: liczba z separatorem tysięcy

Przy angielskich ustawieniach językowych wynik to „16,325.620”.

FormatValue(16325.62,"0,0.000");

Przykład 3: liczba z polskimi ustawieniami językowymi

Wynik to „16 325,62”.

FormatValue(16325.62, "0,000.00", "pl");

Przykład 4: tekst zamiast daty albo liczby

Wynik to „some string value”, bo funkcja nie formatuje tekstu.

FormatValue("some string value", "some format string");

Dobre praktyki

Przekazuj do funkcji datę albo liczbę, np. wartość pola daty albo pola liczbowego.
Podawaj argument language, gdy separatory i nazwy miesięcy mają być takie same niezależnie od ustawień użytkownika.

Typowe błędy

Data albo liczba zapisana jako tekst w cudzysłowie, np. "2015-02-13" albo "16325.62". Funkcja zwróci ten tekst bez zmian. Przekaż datę (np. z funkcji DateTime albo z pola daty) lub liczbę bez cudzysłowu.
Format niepasujący do typu wartości. Wynik będzie nieoczekiwany albo reguła zakończy się błędem. Sprawdź, czy format pasuje do daty albo liczby.
Nieobsługiwany kod języka. Reguła zakończy się błędem. Używaj standardowych kodów języków, np. pl, en, de.