Format függvény

A formázási kifejezésben található utasításoknak megfelelően formázott kifejezést tartalmazó Variant (karakterlánc) értéket ad eredményül.

Figyelmeztetés Probléma merült fel a függvény használatával kapcsolatban. Egyes naptári években az utolsó hétfő 53. hétként adható vissza, amikor annak 1. hétnek kellene lennie. További információt és egy kerülő megoldást a Format és a DatePart függvény hibás hétszámot adhat vissza az év utolsó hétfőjén.

További példák megtekintése

Szintaxis

Format( *kifejezés [, formátum ] [, hétkezdő_nap ] [, évkezdő_hét ] )

A Format függvény argumentumai a következők:

Argumentum	Leírás:
kifejezés	Kötelező. Bármilyen érvényes kifejezés.
formátum	Nem kötelező. Egy érvényes elnevezett vagy felhasználó által definiált formázási kifejezés.
hét_első_napja	Nem kötelező. A hét első napját megadó állandó.
év_első_hete	Nem kötelező. Az év első hetét megadó állandó.

    

Beállítások

A formátum argumentum többféle beállítást is használhat a kifejezésargumentum adattípusától függően. Az érvényes formátumkifejezésekről a következő táblázatban szereplő cikkek nyújtanak további tájékoztatást.

A kifejezés adattípusa	Az ismertetést tartalmazó cikk
Bármilyen típus	Format tulajdonság
Dátum/idő	Dátum- és időmező formázása
Szám	Szám- vagy pénznemmező formázása
Szöveg és feljegyzés	Szövegmező formázása
Igen/Nem	Format tulajdonság – Igen/nem adattípus

    

A hét_első_napja argumentum beállításai a következők:

Állandó	Érték	Leírás:
vbUseSystem	0	Az NLS API beállítás használata.
VbSunday	1	Vasárnap (alapértelmezett)
vbMonday	2	Hétfő
vbTuesday	3	Kedd
vbWednesday	4	Szerda
vbThursday	5	Csütörtök
vbFriday	6	Péntek
vbSaturday	7	Szombat

    

Az év_első_hete argumentum beállításai a következők:

Állandó	Érték	Leírás:
vbUseSystem	0	Az NLS API beállítás használata.
vbFirstJan1	1	Az legyen az első hét, amelybe január 1. esik (alapértelmezett).
vbFirstFourDays	2	Az első olyan hét legyen az év első hete, amelynek legalább négy napja az adott évben van.
vbFirstFullWeek	3	Az év első teljes hete legyen az első hét.

    

Megjegyzések

Formázás	Művelet
Számok	Használhat előre definiált elnevezett számformátumokat, vagy létrehozhat felhasználó által definiált számformátumokat.
Dátum és idő	Használhat előre elnevezett definiált dátum- és időformátumokat, vagy létrehozhat felhasználó által definiált dátum- és időformátumokat.
Dátumot és időt jelölő sorszámok	Dátum- és időformátumokat vagy számformátumokat használhat.
Karakterláncok	Hozza létre saját felhasználói karakterlánc-formátumait.

    

Ha a formátum megadása nélkül próbál meg formázni egy számot, a Format függvény az Str függvényhez hasonló funkciót biztosít, bár a nemzetközi beállításokra ügyel. A Format paranccsal karakterláncként formázott pozitív számok azonban nem tartalmaznak az érték előjele számára lefoglalt vezető szóközt; az Str használatával átalakítottak megtartják a kezdő szóközt.

Ha egy nem honosított numerikus karakterláncot formáz meg, valamilyen felhasználói számformátumot kell használnia, hogy az eredmény biztosan megfeleljen az elvárásainak.

Ha a naptár Gergely-naptár szerinti beállítás, a formázási kifejezés szimbólumainak jelentése változatlan. Ha iszlám naptárról van szó, minden dátumformátum-szimbólumnak (nnnn, mmmm, yyyy) ugyanaz a jelentése, de az iszlám naptárra vonatkozik. A formátumszimbólumok angolok maradnak; A szöveget megjelenítő szimbólumok (például az AM és a PM) az adott szimbólumhoz tartozó (angol vagy arab) karakterláncot jelenítik meg. Iszlám naptár esetén bizonyos szimbólumok tartománya megváltozik.

Szimbólum	Tartomány
d	1–30
dd	1–30
ww	1–51
mmm	A hónapok teljes nevét jeleníti meg (az iszlám hónapneveknek nincs rövidítése).
y	1–355
yyyy	100–9666

Példák

A Format függvény használata kifejezésekbenA Format függvényt mindenhol használhatja, ahol használható kifejezés. Alkalmazhatja például lekérdezésben egy mező aliasának részeként, illetve az űrlapokon vagy jelentésekben szereplő szövegmezők Mező vagy kifejezés tulajdonságában. A következő példák egy olyan kifejezést mutatnak be, amellyel egy jelentés Szűrő tulajdonságában az előző hétre korlátozhatók a megjelenített rekordok.

Format([Dátum],"ww")=Format(Now(),"ww")-1

Ebben a példában a jelentés rekordforrása egy Dátum nevű mező szerepel, amely az egyes rekordok módosításának dátumát tartalmazza, és amelyet fel fogunk használni a jelentésben. A jelentés futtatásakor a program szűri az eredményeket, hogy csak azok a rekordok jelenjenek meg, amelyeknek a Dátum mezőjében szereplő érték hét értéke (Format([Dátum],"ww")) egyenlő az előző héttel (Format(Now(),"ww")-1).

A Format függvény használata VBA-kódban: 

Ebben a példában a Format függvény különféle alkalmazásait mutatjuk be, az elnevezett formátumokra és a felhasználói formátumokra is kiterjedően. A dátumelválasztó (/), az időelválasztó (:) és a de./du. literál esetében a rendszer által ténylegesen megjelenített formázott kimenet függ annak a számítógépnek a területi beállításaitól, amelyen a kód fut. A fejlesztőkörnyezetben a kód területi beállításának megfelelő rövid időformátum és rövid dátumformátum jelenik meg. Futó kódban a rendszer területi beállításának rövid időformátumát és rövid dátumformátumát használja a rendszer, ez pedig eltérő lehet a kód területi beállításától. A példa kedvéért az angol (Egyesült Államok) területi beállítást tételezzük fel.

MyTime és MyDate a fejlesztőkörnyezetben jelennek meg a rendszer aktuális rövid időbeállítása és rövid dátumbeállítása használatával.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s")    ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM")    ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy")    ' Returns "Wednesday,
    ' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23)    ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00")    ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00")    ' Returns "334.90".
MyStr = Format(5, "0.00%")    ' Returns "500.00%".
MyStr = Format("HELLO", "<")    ' Returns "hello".
MyStr = Format("This is it", ">")    ' Returns "THIS IS IT".

      

A formátum használata nulla hosszúságú karakterláncokkal

A Microsoft Access 2.0-s és korábbi verzióiban a Format függvénnyel vissza lehetett adni egy értéket nulla hosszúságú karakterlánc esetén, és egy másikat érték esetén. Például a Format függvénnyel megadott következő formátumkifejezéssel vissza lehetett adni a megfelelő karakterláncértéket a kódból:

Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")

A Microsoft Access 97-es és újabb verzióiban külön tesztelni kell, hogy nem Null-e az érték, majd az eredmény alapján kell visszaadni a megfelelő értéket. Például a következőképpen használható az IIf függvény egy kifejezésben a Format függvénnyel:

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

Ez a változtatás csak arra az esetre érvényes, ha attól függően kíván megformázni egy karakterláncot a Format függvénnyel, hogy nulla hosszúságú karakterláncról vagy Null értékről van-e szó. A Format függvénnyel használt egyéb formátumkifejezések ugyanúgy működnek, mint a korábbi verziókban.

Ha konvertál egy adatbázist a Microsoft Access 2.0-s és korábbi verzióiról a Microsoft Access 2002-es vagy újabb verzióira, módosítania kell úgy a kódot, hogy külön megvizsgálja a Null érték esetét.

Karakterláncfüggvények és használatuk