Atgriež Variant (string), kas satur izteiksme formatētu atbilstoši formāta izteiksmē ietvertajām instrukcijām.
Brīdinājums Ir problēma ar šīs funkcijas lietošanu. Dažu kalendāra gadu pēdējo pirmdienu var atgriezt kā nedēļu 53, ja tā ir 1. nedēļa. Papildinformāciju un risinājumu skatiet rakstā formāta vai DatePart funkciju funkcija ir nepareizas nedēļu skaits pēdējā pirmdienā gadā. |
Sintakse
Format ( izteiksme [, formāts ] [, pirmānedēļasdiena ] [, firstweekofyear ] )
Funkcijas Format sintaksei ir šādi argumenti.
Arguments | Apraksts |
---|---|
izteiksme |
Obligāts. Jebkura derīga izteiksme. |
formāts |
Nav obligāts. Derīga nosaukta vai lietotāja definēta formāta izteiksme. |
pirmā_nedēļas_diena |
Nav obligāts. konstante, kas norāda nedēļas pirmo dienu. |
pirmā_gada_nedēļa |
Nav obligāts. Konstante, kas norāda gada pirmo nedēļu. |
Iestatījumi
Argumentā formāts varat izmantot dažādus iestatījumus atkarībā no argumenta izteiksme datu tipa. Papildinformāciju par derīgām formāta izteiksmēm skatiet nākamajā tabulā norādītajos rakstos.
Izteiksmēm, kas izmanto šo datu tipu... | Skatiet rakstu |
---|---|
Jebkurš tips |
|
Datums/laiks |
|
Skaitlisks |
|
Text un Memo |
|
Jā/nē |
Argumentam pirmānedēļasdiena ir šādi iestatījumi:
Konstante | Vērtība | Apraksts |
---|---|---|
vbUseSystem |
0 |
Izmantojiet NLS API iestatījumu. |
VbSunday |
1 |
Svētdiena (noklusējums) |
vbMonday |
2 |
Pirmdiena |
vbTuesday |
3 |
Otrdiena |
vbWednesday |
4 |
Trešdiena |
vbThursday |
5 |
Ceturtdiena |
vbFriday |
6 |
Piektdiena |
vbSaturday |
7 |
Sestdiena |
Argumentam firstweekofyear ir šādi iestatījumi:
Konstante | Vērtība | Apraksts |
---|---|---|
vbUseSystem |
0 |
Izmantojiet NLS API iestatījumu. |
vbFirstJan1 |
1 |
Sāciet ar nedēļu, kas notiek 1. janvārī (noklusējums). |
vbFirstFourDays |
2 |
Sāciet ar pirmo nedēļu, kurā ir vismaz četras dienas gadā. |
vbFirstFullWeek |
3 |
Sāciet ar gada pirmo pilno nedēļu. |
Piebildes
Lai formatētu | Rīkojieties šādi |
---|---|
skaitļi; |
Lietojiet iepriekš definētus skaitliskos formātus vai izveidojiet lietotāja definētus skaitliskos formātus. |
Datumi un laiki |
Izmantojiet iepriekš definētus nosauktos datuma/laika formātus vai izveidojiet lietotāja definētus datuma/laika formātus. |
Datuma un laika sērijas numuri |
Izmantojiet datuma un laika formātus vai skaitļu formātus. |
Virknes |
Izveidojiet savus lietotāja definētus virknes formātus. |
Ja mēģināt formatēt skaitli, nenorādot formātu, funkcija Format nodrošina tādu pašu funkcionalitāti kā funkcijā str , taču tā ir starptautiski zināma. Taču pozitīviem skaitļiem, kas formatēti kā virknes, izmantojot formātu , nav iekļauta sākuma vieta, kas rezervēts vērtības pazīmei; tie, kas konvertēti, izmantojot str , saglabā sākuma atstarpi.
Ja formatējat nelokalizētu skaitlisko virkni, jāizmanto lietotāja definēts skaitlisks formāts, lai pārliecinātos, vai vēlaties iegūt nepieciešamo izskatu.
Piezīme.: Ja kalendāra rekvizīta iestatījums ir Gregora un formāts norāda datuma formatējumu, norādītajai izteiksmei ir jābūt Gregora sistēmā. Ja Visual Basic kalendāra rekvizīta iestatījums ir Hidžras, norādītajai izteiksmei ir jābūt Hidžras.
Ja kalendārs ir Gregora kalendāra, formāta izteiksmes simbolu nozīme ir nemainīga. Ja šis ir Hidžras kalendārs, visiem datuma formāta simboliem (piemēram, dddd, Mmmm, yyyy) ir vienāda nozīme, bet tie attiecas uz hidžras kalendāru. Formatēšanas simboli paliek angļu valodā. simboli, kas izraisa teksta attēlojumu (piemēram, AM un PM), attēlo virkni (angļu vai arābu), kas ir saistīta ar šo simbolu. Noteiktu simbolu diapazons mainās, kad kalendārs tiek lietots hidžras kalendārā.
Simbols | Diapazons |
---|---|
d |
1-30 |
dd |
1-30 |
ww |
1-51 |
mmm |
Rāda pilnus mēnešu nosaukumus (Hidžras mēnešu nosaukumiem nav saīsinājumu). |
y |
1-355 |
gggg |
100-9666 |
Piemēri
Funkcijas Format lietošana izteiksmē Varat izmantot formātu neatkarīgi no tā, kur varat izmantot izteiksmes. Piemēram, varat to izmantot vaicājumā kā daļu no lauka aizstājvārda vai formas vai atskaites tekstlodziņa rekvizītā Vadīklas avots . Tālāk sniegtajos piemēros ir redzama izteiksme, ko var izmantot atskaites rekvizītā Filter , lai ierobežotu izvadi ar ierakstiem no iepriekšējās nedēļas.
Format ([datums], "ww") = Format (Now (), "ww")-1
Šajā piemērā atskaites ierakstu avotam ir lauks ar nosaukumu Date, kas satur datumu, kad katrs konkrētais ieraksts tika modificēts, un kas tiek izmantots pārskatā. Palaižot atskaiti, tās rezultāti tiek filtrēti, lai rādītu tikai tos ierakstus, kuros nedēļas vērtība datuma laukā (formāts ([datums], "ww")) ir vienāds ar iepriekšējo nedēļu (formāts (tagad (), "ww")-1).
Funkcijas Format lietošana VBA kodā
Piezīme.: Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Lai iegūtu papildinformāciju par darbu ar VBA, nolaižamajā sarakstā atlasiet Uzziņas materiāli izstrādātājiem blakus meklēšanas lodziņam un ievadiet šajā lodziņā vienu vai vairākus vārdus.
Šajā piemērā ir parādīti dažādi funkcijas Format lietojumi, lai formatētu vērtības, izmantojot gan nosauktos formātus, gan lietotāja definētos formātus. Datuma atdalītājs (/), laika atdalītājs (:) un AM/PM literālis, faktiski formatētā izvade, ko attēlo jūsu sistēma, ir atkarīga no tā datora lokalizācijas iestatījumiem, kurā darbojas šis kods. Kad izstrādes vidē tiek parādīti laiki un datumi, tiek izmantots koda lokalizācijas īsais laika formāts un saīsinātais datuma formāts. Ja tiek rādīts palaistais kods, tiek izmantots sistēmas lokalizācijas īsais laika formāts un saīsinātais datuma formāts, kas var atšķirties no koda lokalizācijas. Šajā piemērā tiek pieņemts, ka ASV ir angļu valodas lokalizācija.
MyTime un MyDate tiek parādīti izstrādes vidē, izmantojot pašreizējās sistēmas saīsinātā laika iestatījumu un saīsinātā datuma iestatījumu.
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āta lietošana ar nulles garuma virknēm
Programmas Microsoft Access versijā 2,0 un jaunākās versijās varat izmantot funkciju Format , lai atgrieztu vienu vērtību nulles garuma virkne un citu vērtību. Piemēram, varat izmantot formāta izteiksmi, piemēram, tālāk norādītās funkcijas Format , lai atgrieztu attiecīgo virknes vērtību no koda:
Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")
Programmas Microsoft Access versijās 97 un jaunākās ir jāpārbauda atsevišķi Null gadījumam, pēc tam jāatgriež attiecīgā vērtība, pamatojoties uz rezultātu. Piemēram, varat izmantot funkciju IIf izteiksmē ar funkciju Format , piemēram, šādi:
varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))
Šīs izmaiņas tiek lietotas tikai tad, ja izmantojat funkciju Format , lai formatētu virkni atkarībā no tā, vai tā ir nulles garuma virkne vai vērtība Null. Citas formāta izteiksmes, kas tiek izmantotas funkcijā Format , turpina darboties tāpat kā iepriekšējās versijās.
Ja konvertējat datu bāzi no Microsoft Access versijas 2,0 un vecākām versijām uz Microsoft Access 2002 vai jaunākā versijā, ir jāmaina kods, lai atsevišķi pārbaudītu Null reģistru.