Atgriež Variant (String), kurā ir ietverta izteiksme, kas formatēta saskaņā ar formāta izteiksmē ietvertajiem norādījumiem.
Brīdinājums Šo funkciju var lietot, izmantojot šādu problēmu. Dažu kalendāra gadu pēdējo pirmdienu var atgriezt kā 53. nedēļu, ja tai ir jābūt 1. nedēļai. Papildinformāciju un risinājumu skatiet rakstā Formatēšana vai DatePart funkcijas var atgriezt nepareizu nedēļas numuru pagājušajā pirmdienā gadā. |
Sintakse
Format( izteiksme [, formāts ] [, pirmā_nedēļas_diena ] [, pirmā_gada_nedēļa ] )
Funkcijas Format sintaksē ir šādi argumenti:
Arguments |
Apraksts |
izteiksme |
Obligāts arguments. Jebkura derīga izteiksme. |
formāts |
Neobligāts arguments. Derīga nosaukta vai lietotāja definēta formāta izteiksme. |
pirmā_nedēļas_diena |
Neobligāts arguments. A konstante kas norāda nedēļas pirmo dienu. |
pirmā_gada_nedēļa |
Neobligāts arguments. Konstante, kas norāda gada pirmo nedēļu. |
Iestatījumi
Formāta arguments var izmantot dažādus iestatījumus atkarībā no izteiksmes argumenta datu tipa. Lai iegūtu papildinformāciju par derīgā formāta izteiksmēm, skatiet šajā tabulā norādītos rakstus.
Izteiksmēm, kas izmanto šo datu tipu... |
Skatiet rakstu |
Jebkura tipa |
|
Datums/laiks |
|
Skaitlisks |
|
Teksts un zīmītis |
|
Jā/nē |
Argumentam pirmā_nedēļas_diena 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 pirmā_gada_nedēļa ir šādi iestatījumi:
Konstante |
Vērtība |
Apraksts |
vbUseSystem |
0 |
Izmantojiet NLS API iestatījumu. |
vbFirstJan1 |
1 |
Sākas ar nedēļu, kurā ir 1. janvāris (noklusējums). |
vbFirstFourDays |
2 |
Sāciet ar pirmo nedēļu, kurā ir vismaz četras dienas gadā. |
vbFirstFullWeek |
3 |
Sāciet ar pirmo pilno gada nedēļu. |
Piebildes
Lai formatētu |
Rīkojieties šādi |
skaitļi; |
Izmantojiet iepriekš definētus nosauktus skaitļu formātus vai izveidojiet lietotāja definētus skaitļu formātus. |
Datumi un laiki |
Izmantojiet iepriekš definētus nosauktus 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 virkņu formātus. |
Ja mēģināsiet formatēt skaitli, nenorādījot formātu, formāts nodrošina funkcionalitāti, kas līdzīga funkcijai Str, lai gan tas ir internationally aware. Tomēr pozitīvie skaitļi, kas formatēti kā virknes, izmantojot formātu, neietver sākuma atstarpi, kas rezervēta vērtības zīmei. tiem, kas pārveidoti, izmantojot Str, saglabājas sākuma atstarpe.
Ja formatējat ne lokālu skaitlisku virkni, izmantojiet lietotāja definētu skaitlisku formātu, lai nodrošinātu, ka iegūstat jums vēlamo izskatu.
Piezīme.: Ja rekvizīta Kalendārs iestatījums ir Gregora kalendārs un norāda datuma formatējumu, nodrošinātajai izteiksmei ir jābūt Gregora kalendāram. Ja rekvizīta Visual Basic kalendārs iestatījums ir Hidžras, nodrošinātajai izteiksmei ir jābūt Hidžri.
Ja kalendārs ir Gregora kalendārs , izteiksmju simbolu formatēšanas nozīme netiek mainīta. Ja kalendārs ir Hidžras, visiem datuma formāta simboliem (piemēram, dddd, mmmm, gggg) ir vienāda nozīme, bet tie attiecas uz Hidžras kalendāru. Simbolu formatēšana paliek angļu valodā; simboli, kuru rezultātā tiek rādīts teksts (piemēram, AM un PM), parāda ar šo simbolu saistīto virkni (angļu vai arābu valodā). Noteiktu simbolu diapazons mainās, ja kalendārs ir Hidžras.
Simbols |
Diapazons |
d |
1-30 |
dd |
1-30 |
ww |
1-51 |
mmm |
Parāda pilnu mēnešu nosaukumus (Hidžras mēnešu nosaukumiem nav saīsinājumu). |
y |
1-355 |
gggg |
100-9666 |
Piemēri
Funkcijas Format izmantošana izteiksmē Varat izmantot formātu visur , kur varat izmantot izteiksmes. Piemēram, to var izmantot vaicājumā kā lauka aizstājvārda daļu vai formas vai atskaites tekstlodziņa rekvizītā Vadīklas avots. Tālākajos piemēros ir parādīta izteiksme, kuru varat izmantot atskaites rekvizītā Filtrs , lai ierobežotu izvadi līdz ierakstiem no iepriekšējās nedēļas.
Format([Date],"ww")=Format(Now(),"ww")-1
Šajā piemērā atskaites ieraksta avotā ir lauks ar nosaukumu Datums, kas satur katra konkrētā ieraksta modificēšanas datumu, kurš tiek izmantots atskaitē. Palaižot atskaiti, tās rezultāti tiek filtrēti, lai rādītu tikai tos ierakstus, kuros vērtības nedēļa laukā Datums (Format([Date],"ww")) ir vienāda ar iepriekšējo nedēļu (Format(Now(),"ww")-1).
Funkcijas Format izmantoš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ā redzamas dažādas funkcijas Format (Formāts) izmantošana vērtību formatēšanai, izmantojot gan nosauktos, gan lietotāja definētos formātus. Datuma atdalītāja (/), laika atdalītāja (:) un AM/ PM literāļa gadījumā faktiskais formatētais rezultāts, ko attēlo jūsu sistēma, ir atkarīgs no tā datora lokālajiem iestatījumiem, kurā darbojas kods. Kad laiks un datumi tiek rādīti izstrādes vidē, tiek izmantots koda lokalizācijas saīsinātais laika formāts un saīsinātais datuma formāts. Ja tiek rādīts, izmantojot kodu, tiek izmantots sistēmas lokalizācijas īsais un īsais datuma formāts, kas var atšķirties no koda lokalizācijas. Šajā piemērā tiek pieņemts, ka ASV angļu valodas lokalizācija.
MyTime un MyDate iestatījumi tiek rādīti izstrādes vidē, izmantojot pašreizējo sistēmas īsā 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".
Formatēšana ar nulles garuma virknēm
Microsoft Access versijā 2.0 un vecākās versijās varat izmantot funkciju Formāts, lai atgrieztu vienu vērtību nulles garuma virkne otru vērtībai. Piemēram, varat izmantot formāta izteiksmi, piemēram, tālāk norādīto ar funkciju Formāts , lai atgrieztu atbilstošu 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")
Microsoft Access 97 un jaunākās versijās atsevišķi jātestē Null gadījums, pēc tam jāatgriež atbilstoša vērtība, pamatojoties uz rezultātu. Piemēram, funkciju IIf varat izmantot izteiksmē ar funkciju Formāts , piemēram, šādi:
varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))
Šīs izmaiņas tiek lietotas tikai tad, ja formāta funkciju izmanto virknes formatēšanai atkarībā no tā, vai tā ir nulles garuma virkne vai vērtība Null. Citas formāta izteiksmes, kas tiek izmantotas kopā ar funkciju Formāts, turpina darboties tāpat kā iepriekšējās versijās.
Ja konvertējat datu bāzi no Microsoft Access versijas 2.0 un vecākas versijas uz Microsoft Access 2002 vai jaunāku versiju, jums ir jāmaina kods, lai atsevišķi pārbaudītu Null reģistru.