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 évek utolsó hétfője az 53. hét, amikor az 1. hétnek kell lennie. További információkért és kerülő megoldásért lásd: A Format vagy a DatePart függvény nem a megfelelő heti számot adja vissza a múlt hétfőre vonatkozóan az év sorá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átumargumentum a kifejezésargumentum adattípusától függően számos beállítást használhat. 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énznem mező 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 Formátum az Str függvényhez hasonló funkciókat biztosít, bár nemzetközileg is tisztában van vele. A Format használatával sztringként formázott pozitív számok azonban nem tartalmaznak az érték előjeléhez fenntartott kezdő szóközt; az Str használatával konvertáltak megőrzik 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, a formázási kifejezések szimbólumainak jelentése nem változik. Ha a naptár hijri, minden dátumformátumszimbólum (például dddd, mmmm, yyyy) ugyanazt a jelentést használja, de a Hijri naptárra vonatkozik. A formátumszimbólumok angol nyelvűek maradnak; A szöveges megjelenítést eredményező szimbólumok (például AM és PM) az adott szimbólumhoz társított sztringet (angol vagy arab) jelenítik meg. Bizonyos szimbólumok tartománya megváltozik, ha a naptár hijri.

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ésben A Formátum parancsot bárhol használhatja, ahol kifejezéseket használhat. 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ásának van egy Date (Dátum) nevű mezője, amely tartalmazza az egyes rekordok módosításának dátumát, és amelyet a jelentés használ. A jelentés futtatásakor a rendszer úgy szűri az eredményeket, hogy csak azokat a rekordokat jelenítse meg, ahol a Dátum mező (Format([Date],"ww")) értékének hete megegyezik az előző hétvel (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 az AM/PM literál esetében a rendszer által megjelenített tényleges formázott kimenet annak a számítógépnek a területi beállításaitól függ, 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 MyDate és a jelenik meg a fejlesztési környezetben az aktuális rendszer rövid idő beállításával és a rövid dátum beállítással.

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".

      

Formátum használata nulla hosszúságú sztringekkel

A Microsoft Access 2.0-s és korábbi verzióiban a Format függvénnyel egy értéket adhat vissza egy nulla hosszúságú sztringhez, egy másikat pedig egy értékhez. 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