Modul
Vsebina
Kazalo 🔎︎

# Funkcija FormatNumber [VBA]

Vrne niz z uporabljenim oblikovanjem števil nad numeričnim izrazom.

Ta funkcija ali konstanta je omogočena z ukazom Option VBASupport 1, ki ga moramo vstaviti pred izvedljivo programsko kodo v modulu.

## Skladnja:

    FormatNumber( expression, numDigitsAfterDecimal as Integer, includeLeadingDigit as Integer,
     useParensForNegativeNumbers as Integer, groupDigits as Integer )

## Vrnjena vrednost:

String

## Parametri:

Izraz (obvezno): numeričen izraz, ki ga želite oblikovati.

štŠtevkPoDecimalki: neobvezno. Številska vrednost, ki določa število decimalk, ki naj bodo prikazane. Če je izpuščeno, ima privzeto vrednost -1, kar pomeni, da bodo uporabljene privzete nastavitve za uporabniški vmesnik.

includeLeadingDigit: neobvezno. Vrednost številčenja vbTriState, ki določa, ali naj bo za ulomljene vrednosti prikazana vodilna ničla.

- vbTrue ali -1: prikaži vodilno ničlo.

- vbFalse ali 0: ne prikaži vodilnih ničel.

- vbUseDefaults ali -2: uporabi krajevne nastavitve uporabniškega vmesnika. To je privzeto, če je izpuščeno.

useParensForNegativeNumbers: neobvezno. Vrednost številčenja vbTriState, ki določa, ali naj bodo negativna števila označena z oklepaji.

- vbTrue ali -1: uporabite okrogle oklepaje za negativna števila.

- vbFalse ali 0: ne prikaži oklepajev.

- vbUseDefaults ali -2: enako kot vbFalse. To je privzeto, če je izpuščeno.

groupDigits: neobvezno. Vrednost številčenja vbTriState, ki določa, da naj bo število pokupčkano (po tisočicah itn.) z uporabo skupinskega ločila, ki je naveden v krajevnih nastavitvah sistema.

- vbTrue ali -1: združi števke.

- vbFalse ali 0: ne združi števk.

- vbUseDefaults ali -2: enako kot vbFalse. To je privzeto, če je izpuščeno.

## Kode napak:

13 Vrsta spremenljivk se ne ujema

## Primer:

    Sub TestFormatNumeber

    testName = "Test 1: positive, 2 decimals"

    str2 = "12.20"

    str1 = FormatNumber("12.2", 2, vbFalse, vbFalse, vbFalse)

    msgbox( "FormatNumber returned: " + str1 + ", Expected: " + str2)

    testName = "Test 2: negative, 20 decimals, use leading zero"

    str2 = "-0.20000000000000000000"

    str1 = FormatNumber("-.2", 20, vbTrue, vbFalse, vbFalse)

    msgbox( "FormatNumber returned: " + str1 + ", Expected: " + str2)

    testName = "Test 3: negative, 20 decimals, no leading zero"

    str2 = "-.20000000000000000000"

    str1 = FormatNumber("-0.2", 20, vbFalse, vbFalse, vbFalse)

    msgbox( "FormatNumber returned: " + str1 + ", Expected: " + str2)

    testName = "Test 4: negative, no leading zero, use parens"

    str2 = "(.20)"

    str1 = FormatNumber("-0.2", -1, vbFalse, vbTrue, vbFalse)

    msgbox( "FormatNumber returned: " + str1 + ", Expected: " + str2)

    testName = "Test 5: negative, default leading zero, use parens"

    str2 = "(0.20)"

    str1 = FormatNumber("-0.2", -1, vbUseDefault, vbTrue, vbFalse)

    msgbox( "FormatNumber returned: " + str1 + ", Expected: " + str2)

    testName = "Test 6: group digits"

    str2 = "-12,345,678.00"

    str1 = FormatNumber("-12345678", -1, vbUseDefault, vbUseDefault, vbTrue)

    msgbox( "FormatNumber returned: " + str1 + ", Expected: " + str2)

    End Sub

Podobne teme

Matematične funkcije VBA