Funcția Format

Returnează o valoare variant (șir) care conține o expresie formatată în conformitate cu instrucțiunile conținute într-o expresie de format.

Avertisment Există o problemă cu utilizarea acestei funcții. Ultima zi de luni din unii ani calendaristici poate fi returnată ca săptămâna 53, când ar trebui să fie săptămâna 1. Pentru mai multe informații și o soluție de evitare, consultați Format sau DatePart Funcțiile pot returna un număr de săptămână greșit pentru ultima zi de luni din an.

Vedeți câteva exemple

Sintaxă

Format( *expresie [, format ] [, primazidinsăptămână ] [, primasăptămânădinan ] )

Sintaxa funcției Format are următoarele argumente:

Argument	Descriere
expresie	Obligatoriu. Orice expresie validă.
formatare	Opțional. O expresie de format denumită valid sau definită de utilizator.
prima zi a săptămânii	Opțional. O constantă care specifică prima zi a săptămânii.
primasăptămânădinan	Opțional. Este o constantă care specifică prima săptămână a anului.

    

Setări

Argumentul format poate utiliza o varietate de setări, în funcție de tipul de date al argumentului expresiei . Consultați articolele listate în tabelul următor pentru mai multe informații despre expresiile de format valide.

Pentru expresiile care utilizează acest tip de date...	Consultați articolul
Orice tip	Proprietatea Format
Dată/oră	Formatarea unui câmp dată și oră
Numeric	Formatarea unui câmp număr sau monedă
Text și memo	Formatarea unui câmp text
Da/Nu	Proprietatea Format - tipul de date Da/Nu

    

Argumentul prima zi a săptămânii are aceste setări:

Constantă	Valoare	Descriere
vbUseSystem	0	Utilizați setarea API NLS.
VbSunday	1	Duminică (implicit)
vbMonday	2	Luni
vbTuesday	3	Marți
miercuri vb	4	Miercuri
vbThursday	5	Joi
vbFriday	6	Vineri
vbSaturday	7	Sâmbătă

    

Argumentul primăsăptămânădinan are aceste setări:

Constantă	Valoare	Descriere
vbUseSystem	0	Utilizați setarea API NLS.
vbFirstJan1	1	Începeți cu săptămâna în care pică 1 ianuarie (implicit).
vbFirstFourDays	2	Începeți cu prima săptămână care are cel puțin patru zile într-un an.
vbFirstFullWeek	3	Începeți cu prima săptămână completă a anului.

    

Observații

Pentru a formata	Procedați astfel
Numere	Utilizați formate numerice denumite predefinite sau creați formate numerice definite de utilizator.
Date și ore	Utilizați formate dată/oră denumite predefinite sau creați formate de dată/oră definite de utilizator.
Numerele seriale de dată și oră	Utilizați formate de dată și oră sau formate numerice.
Șiruri	Creați-vă propriile formate de șir, definite de utilizator.

    

Dacă încercați să formatați un număr fără a specifica formatul, Format oferă o funcționalitate similară funcției Str , deși este recunoscut la nivel internațional. Cu toate acestea, numerele pozitive formatate ca șiruri folosind Format nu includ un spațiu inițial rezervat pentru semnul valorii; cele convertite utilizând Str păstrează spațiul inițial.

Dacă formatați un șir numeric nelocalizat, trebuie să utilizați un format numeric definit de utilizator, pentru a vă asigura că obțineți aspectul dorit.

Dacă calendarul este gregorian, semnificația simbolurilor de formatare a expresiilor rămâne neschimbată. Dacă calendarul este Hijri, toate simbolurile de format de dată (de exemplu, dddd, mmmm, yyyy) au aceeași semnificație, dar se aplică și calendarului Hijri. Simbolurile de format rămân în limba engleză; simbolurile care au ca rezultat afișarea textului (de exemplu, AM și PM) afișează șirul (în limba engleză sau arabă) asociat cu acel simbol. Intervalul anumitor simboluri se modifică atunci când calendarul este Hijri.

Simbol	Zonă
d	1-30
dd	1-30
ww	1-51
mmm	Afișează numele complet al lunilor (numele lunilor Hijri nu au abrevieri).
y	1-355
yyyy	100-9666

Exemple

Utilizarea funcției Format într-o expresiePuteți utiliza Format oriunde puteți utiliza expresii. De exemplu, o puteți utiliza într-o interogare ca parte a unui alias de câmp sau în proprietatea Sursă control a unei casete text dintr-un formular sau dintr-un raport. Următoarele exemple arată o expresie pe care o puteți utiliza într-un raport Filter property pentru a limita rezultatul la înregistrările din săptămâna anterioară.

Format([Dată],"ww")=Format(Now(),"ww")-1

În acest exemplu, sursa de înregistrări a raportului are un câmp denumit Dată, care conține data la care a fost modificată fiecare înregistrare și care este utilizat în raport. Când rulați raportul, rezultatele sale sunt filtrate pentru a afișa numai înregistrările unde săptămâna pentru valoarea din câmpul Dată (Format([Dată],"ww")) este egală cu săptămâna anterioară (Format(Now(),"ww")-1).

Utilizați funcția Format în codul VBA 

Acest exemplu arată diverse utilizări ale funcției Format pentru a formata valori, utilizând atât formate denumite, cât și formate definite de utilizator. Pentru separatorul de dată (/), separatorul de oră (:) și literalul AM/PM, rezultatul formatat propriu-zis afișat de sistemul dvs. depinde de setările regionale ale computerului pe care rulează codul. Când se afișează orele și datele în mediul de dezvoltare, se utilizează formatul dată scurtă și formatul dată scurtă pentru codul local. Când este afișat de cod în execuție, se utilizează formatul dată scurtă și formatul dată scurtă al setărilor regionale ale sistemului, care pot diferi de setările regionale de cod. Pentru acest exemplu, se utilizează setarea regională în engleză SUA.

MyTime și MyDate sunt afișate în mediul de dezvoltare utilizând setarea curentă a sistemului pentru oră scurtă și setarea pentru dată scurtă.

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

      

Utilizarea formatării cu șiruri de lungime zero

În Microsoft Access versiunea 2.0 și versiunile anterioare, puteți utiliza funcția Format pentru a returna o valoare pentru un șir de lungime zero și alta pentru o valoare. De exemplu, puteți utiliza o expresie de format cum urmează cu funcția Format pentru a returna valoarea de șir corespunzătoare din cod:

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

În Microsoft Access versiunile 97 și mai recente, trebuie să testați separat pentru corpul de literă Nul , apoi să returnați valoarea corespunzătoare pe baza rezultatului. De exemplu, puteți utiliza funcția IIf într-o expresie cu funcția Format , cum ar fi următoarea:

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

Această modificare se aplică numai atunci când utilizați funcția Format pentru a formata un șir în funcție de faptul dacă acesta este un șir de lungime zero sau o valoare nulă. Alte expresii de formatare utilizate cu funcția Format continuă să funcționeze ca în versiunile anterioare.

Dacă efectuați conversia unei baze de date din Microsoft Access versiunea 2.0 și o versiune anterioară la Microsoft Access 2002 sau o versiune mai recentă, trebuie să schimbați codul pentru a testa separat pentru corpul Nul.

Funcțiile de șir și utilizarea acestora