Funkcija Format

Vrne podatkovni tip Različica (niz), ki vsebuje izraz, oblikovan v skladu z navodili v izrazu oblikovanja.

Opozorilo Pri uporabi te funkcije je prišlo do težave. Zadnji ponedeljek v nekaterih koledarskih letih je lahko vrnjen kot 53. teden, medtem ko bi moral biti 1. teden. Če želite več informacij in nadomestno rešitev, glejte »Oblika« ali pa lahko funkcije »DatePart« vrnejo napačno številko tedna za zadnji ponedeljek v letu.

Nekaj primerov

Sintaksa

Format( *izraz [, oblika ] [, prvi dan v tednu ] [, prvi teden v letu ] )

Sintaksa funkcije Format ima te argumente:

Argument	Opis
izraz	Obvezno. Kateri koli veljaven izraz.
Oblika zapisa	Izbirno. Veljavno poimenovan ali uporabniško določen izraz oblike zapisa.
Prvi dan v tednu	Neobvezen. Konstanta, ki določa prvi dan v tednu.
Prvi teden v letu	Izbirno. Konstanta, ki določa prvi teden v letu.

    

Nastavitve

Argument »oblika « lahko uporablja različne nastavitve, odvisno od podatkovnega tipa argumenta izraza . Preberite članke v tej tabeli, če želite več informacij o veljavnih izrazih oblike zapisa.

Za izraze, ki uporabljajo ta podatkovni tip ...	Glejte članek
Poljubna vrsta	Lastnost »Format«
Datum/čas	Oblikovanje polja za datum in uro
Številka	Oblikovanje polja s številom ali valuto
Besedilo in zapisek	Oblikovanje polja z besedilom
Da/ne	Lastnost »Format« – podatkovni tip Da/ne

    

Argument prvi dan v tednu ima te nastavitve:

Konstanta	Vrednost	Opis
vbUseSystem	0	Uporabite nastavitev NLS API.
VbSunday	1	Nedelja (privzeto)
vbMonday	2	Ponedeljek
vbTuesday	3	Torek
vbWednesday	4	Sreda
vbThursday	5	Četrtek
vbFriday	6	Petek
vbSaturday	7	Sobota

    

Argument prvi teden v letu ima te nastavitve:

Konstanta	Vrednost	Opis
vbUseSystem	0	Uporabite nastavitev NLS API.
vbFirstJan1	1	Začnite s tednom, v katerem je 1. januar (privzeto).
vbFirstFourDays	2	Začnite s prvim tednom, ki ima vsaj štiri dni v letu.
vbFirstFullWeek	3	Začnite s prvim popolnim tednom v letu.

    

Opombe

Za oblikovanje	Naredite to
Številke	Uporabite predhodno imenovane številske oblike zapisa ali ustvarite uporabniško določene številske oblike zapisa.
Datum in ura	Uporabite predhodno imenovane oblike zapisa za datum/čas ali ustvarite uporabniško določene oblike zapisa za datum/čas.
Zaporedne številke datuma in časa	Uporabite oblike zapisa za datum in čas ali oblike zapisa števil.
Nizi	Ustvarite lastne uporabniško določene oblike zapisa.

    

Če želite oblikovati število, ne da bi navedli obliko zapisa, funkcija Format omogoča funkcionalnost, podobno funkciji Str, čeprav z upoštevanjem mednarodnih značilnosti. Vendar pa pozitivna števila, oblikovana kot nizi z uporabo funkcije Format ne vsebujejo začetnega presledka, rezerviranega za predznak vrednosti; nizi, pretvorjeni s funkcijo Str, ohranijo začetni presledek.

Če oblikujete nelokalizirani številski niz, uporabite uporabniško določeno obliko zapisa, da zagotovite želeni videz.

Če je koledar gregorijanski, je pomen simbolov izraza oblike nespremenjen. Če je koledar hidžra, imajo vsi simboli oblike zapisa datuma (na primer dddd, mmmm, llll) enak pomen, vendar veljajo za koledar hidžre. Simboli oblike ostanejo v angleščini; simboli, ki povzročijo prikaz besedila (na primer AM in PM), prikažejo niz (angleški ali arabski), povezan s tem simbolom. Obseg določenih simbolov se spremeni, ko je koledar hidžra.

Simbol	Obseg
d	1-30
dd	1-30
ww	1-51
mmm	Prikaže polna imena mesecev (imena islamskih mesecev nimajo okrajšav).
y	1-355
yyyy	100-9666

Primeri

Uporaba funkcije »Oblika« v izrazuObliko lahko uporabite povsod, kjer lahko uporabljate izraze. Uporabite jo lahko na primer v poizvedbi kot del vzdevka polja ali v lastnosti Control Source polja z besedilom v obrazcu ali poročilu. V naslednjih primerih je prikazan izraz, ki ga lahko uporabite v lastnosti Filter poročila, da omejite izpis zapisov prejšnjega tedna.

Format ([datum], "ww") = Format (zdaj (); "ww") -1

V tem primeru vsebuje vir zapisa poročila polje z imenom datum, ki vsebuje datum, ko je bil vsak posamičen zapis spremenjen, in ki se uporablja v poročilu. Ko zaženete poročilo, se njegovi rezultati filtrirajo tako, da se prikažejo samo zapisi, kjer je teden za vrednost v polju za datum (Format([datum],"ww")) enak prejšnjemu tednu (Format(zdaj(),"ww")-1).

Uporaba funkcije »Format« v kodi VBA 

V tem primeru so prikazane različne uporabe funkcije Format za oblikovanje vrednosti z uporabo obeh, poimenovanih oblik zapisa in uporabniško določenih oblik zapisa. Za ločilo datuma (/), ločilo časa (:) in dobesedno AM/PM je dejanski formatiran izhod, ki ga prikaže sistem, odvisen od območnih nastavitev računalnika, v katerem se koda izvaja. Ko so datumi in časi prikazani v razvojnem okolju, se uporabita kratki obliki zapisa za datum in čas področnih nastavitev kode. Pri prikazu z izvajanjem kode se uporabita kratki obliki zapisa za datum in čas sistemskih področnih nastavitev, ki se lahko razlikujejo od področnih nastavitev kode. V tem primeru so predpostavljene angleške področne nastavitve (ZDA).

MyTime in so prikazani MyDate v razvojnem okolju z uporabo trenutne sistemske nastavitve kratkega časa in kratke nastavitve datuma.

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

      

Uporaba oblike zapisa z nizi ničelne dolžine

V Microsoft Accessu različice 2.0 in starejših različicah lahko s funkcijo Oblika vrnete eno vrednost za niz ničelne dolžine in drugo za vrednost. S funkcijo Format lahko na primer uporabite izraz oblike, kot je ta, da vrnete ustrezno vrednost niza iz kode:

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

V različicah Microsoft Access 97 in novejših morate posebej preskušati ničelno vrednost, nato pa povrniti ustrezno vrednost na osnovi rezultata. Funkcijo IIf je bilo na primer mogoče uporabiti v izrazu s funkcijo Format, kot je ta:

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

Ta sprememba velja samo, če funkcijo Format uporabljate za oblikovanje niza, glede na to, ali je niz ničelne dolžine ali ničelne vrednosti. Drugi izrazi oblike zapisa, ki se uporabljajo s funkcijo Format delujejo tako, kot so v prejšnjih različicah.

Če pretvorite zbirko podatkov iz programa Microsoft Access različice 2.0 in starejših v Microsoft Access 2002 ali novejšo, morate spremeniti kodo za ločeni preskus ničelne vrednosti.

Funkcije niza in njihova uporaba