Returnează o valoare variant (șir) care conține o expresie formatată conform instrucțiunilor conținute într-o expresie de formatare.
|
Avertisment Există o problemă cu utilizarea acestei funcții. Ultima lune 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, consultați Funcțiile Format sau DatePart pot returna numărul săptămânii greșite pentru ultima zi de luni din an. |
Sintaxă
Format( expresie [, format ] [, primazidinsămână ] [, primasămânădinan ] )
Sintaxa funcției Format are următoarele argumente:
|
Argument |
Descriere |
|
expresie |
Obligatoriu. Orice expresie validă. |
|
format |
Opțional. O expresie de format denumită sau definită de utilizator validă. |
|
primazidinsămână |
Opțional. Un constantă care specifică prima zi a săptămânii. |
|
primasămânădinan |
Opțional. 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 în format valid.
|
Pentru expresiile care utilizează acest tip de date... |
Consultați articolul |
|
Orice tip |
|
|
Dată/oră |
|
|
Numeric |
|
|
Text și memo |
|
|
Da/Nu |
Argumentul firstdayofweek are aceste setări:
|
Constantă |
Valoare |
Descriere |
|
vbUseSystem |
0 |
Utilizați setarea NLS API. |
|
Zi vbsunday |
1 |
Duminică (implicit) |
|
vbMonday |
2 |
Luni |
|
zi vbTuesday |
3 |
Marți |
|
zi vbWednesday |
4 |
Miercuri |
|
zi vbThursday |
5 |
Joi |
|
vbFriday |
6 |
Vineri |
|
vbSaturday |
7 |
Sâmbătă |
Argumentul firstweekofyear are următoarele setări:
|
Constantă |
Valoare |
Descriere |
|
vbUseSystem |
0 |
Utilizați setarea NLS API. |
|
vbFirstJan1 |
1 |
Începeți cu săptămâna în care are loc 1 ianuarie (implicit). |
|
vbFirstFourDays |
2 |
Începeți cu prima săptămână care are cel puțin patru zile din 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 predefinite denumite sau creați formate numerice definite de utilizator. |
|
Date și ore |
Utilizați formate predefinite de dată/oră sau creați formate de dată/oră definite de utilizator. |
|
Numere seriale dată și oră |
Utilizați formate de dată și oră sau formate numerice. |
|
Siruri |
Creați propriile formate de șir definite de utilizator. |
Dacă încercați să formatați un număr fără a specifica formatul, formatul oferă funcționalitate similară cu funcția Str , deși este la nivel internațional. Totuși, numerele pozitive formatate ca șiruri utilizând Format nu includ un spațiu la început rezervat pentru semnul valorii; cele convertite utilizând Str păstrează spațiul de la început.
Dacă formatați un șir numeric ne localizat, trebuie să utilizați un format numeric definit de utilizator pentru a vă asigura că obțineți aspectul dorit.
Notă: Dacă setarea proprietății Calendar este gregoriană și formatul specifică formatarea de dată, expresia furnizată trebuie să fie gregoriană. Dacă setarea proprietății Calendar Visual Basic este Hijri, expresia furnizată trebuie să fie Hijri.
Dacă calendarul este gregorian, semnificația simbolurilor de formatare a expresiilor este neschimbată. Dacă calendarul este Hijri, toate simbolurile format de dată (de exemplu, dddd, mmmm, yyyy) au aceeași semnificație, dar se aplică la calendarul Hijri. Simbolurile de formatare rămân în limba engleză; simbolurile care au ca rezultat afișarea textului (de exemplu, AM și PM) afișează șirul (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 complete ale lunilor (numele lunilor Hijri nu au abrevieri). |
|
y |
1-355 |
|
yyyy |
100-9666 |
Exemple
Utilizarea funcției Format într-o expresie Puteț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 raport. Următoarele exemple arată o expresie pe care o puteți utiliza în proprietatea Filter a unui raport pentru a limita ieșirea la înregistrări 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. Atunci când rulați raportul, rezultatele sale sunt filtrate pentru a afișa doar înregistrările în care 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).
Utilizarea funcției Format în cod VBA
Notă: Exemplele care urmează demonstrează utilizarea acestei funcții într-un modul Visual Basic for Applications (VBA). Pentru mai multe informații despre lucrul cu VBA, selectați Referințe pentru dezvoltatori în lista verticală de lângă Căutare și introduceți unul sau mai mulți termeni în caseta de căutare.
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, ieșirea formatată reală afișată de sistem depinde de setările regionale ale computerului pe care rulează codul. Atunci când orele și datele sunt afișate în mediul de dezvoltare, se utilizează formatul pentru oră scurtă și dată scurtă pentru setările regionale de cod. Când se afișează prin rularea codului, se utilizează formatul pentru oră scurtă și formatul de dată scurtă pentru setările regionale ale sistemului, care pot fi diferite de setările regionale ale codului. Pentru acest exemplu, se presupune setarea regională engleză sua.
MyTime și MyDate sunt afișate în mediul de dezvoltare utilizând setarea curentă de timp scurt a sistemului ș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 formatului 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 o șir de lungime zero și alta pentru o valoare. De exemplu, puteți utiliza o expresie de formatare, cum ar fi următoarea, cu funcția Format pentru a returna valoarea ș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 Versiunile 97 de Microsoft Access și ulterioare, trebuie să testați separat pentru cazul Null , 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ătoarele:
varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))
Această modificare se aplică doar atunci când utilizați funcția Format pentru a formata un șir dependent de un șir de lungime zero sau o valoare Null. Alte expresii de format utilizate cu funcția Format continuă să funcționeze ca în versiunile anterioare.
Dacă efectuați conversia unei baze de date de la Microsoft Access versiunea 2.0 și versiunile anterioare la Microsoft Access 2002 sau o versiune mai recentă, trebuie să modificați codul pentru a testa separat pentru cazul Null.
