Funkcija Format

Atgriež Variant (String) vērtību, kas ietver izteiksmi, kas formatēta saskaņā ar formāta izteiksmē ietvertajām instrukcijām.

Brīdinājums Šīs funkcijas lietojumā radās problēma. Dažu kalendāro gadu pēdējo pirmdienu var atgriezt kā 53. nedēļu, bet tai vajadzētu būt 1. nedēļai. Papildinformāciju un risinājumu skatiet sadaļā Formāts vai DatePart funkcijas var atgriezt nepareizu nedēļas numuru gada pēdējai pirmdienai.

Skatiet dažus piemērus

Sintakse

Format( *izteiksme [, formāts ] [, pirmā_nedēļas_diena ] [, pirmā_gada_nedēļa ] )

Funkcijas Format sintaksei ir šādi argumenti:

Arguments	Apraksts
izteiksme	Obligāti. 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. 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 argumentam var tikt izmantoti dažādi iestatījumi atkarībā no izteiksmes argumenta 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š veids	Rekvizīts Format
Datums/laiks	Datuma un laika lauka formatēšana
Skaitlisks	Skaitļa vai valūtas lauka formatēšana
Teksts un piezīmes	Teksta lauka formatēšana
Jā/nē	Rekvizīts Format— datu tips Yes/No

    

Argumentam pirmā_nedēļas_diena ir šādi iestatījumi:

Konstante	Vērtība	Apraksts
vbUseSystem	0	Izmantot NLS API iestatījumu.
Vbsvētdiena	1	Svētdiena (noklusējums)
vbPirmdiena	2	Pirmdiena
vbOtrdiena	3	Otrdiena
vbWednesday	4	Trešdiena
vbCeturtdiena	5	Ceturtdiena
vbFriday	6	Piektdiena
vbSestdiena	7	Sestdiena

    

Argumentam pirmā_gada_nedēļa ir šādi iestatījumi:

Konstante	Vērtība	Apraksts
vbUseSystem	0	Izmantot NLS API iestatījumu.
vbPirmaisJan1	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ā.
vbPirmāPilnā nedēļa	3	Sāciet ar pirmo pilno gada nedēļu.

    

Piezīmes

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 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ētos virkņu formātus.

    

Ja mēģināt formatēt skaitli, nenorādot formātu, formāta funkcionalitāte ir līdzīga funkcijas Str funkcionalitātei, lai gan tā ir pazīstama starptautiski. Tomēr pozitīvajiem skaitļiem, kas formatēti kā virknes, izmantojot formātu , nav vērtības zīmei rezervētas sākuma vietas; tie, kas konvertēti, izmantojot Str , saglabā atstarpi sākumā.

Ja formatējat nelokalizētu skaitļu virkni, izmantojiet lietotāja definētu skaitļu formātu, lai iegūtu vajadzīgo izskatu.

Ja kalendārs ir Gregora kalendārs, formāta izteiksmju simbolu nozīme nav mainīta. Ja kalendārs ir Hidžras, visiem datuma formāta simboliem (piemēram, dddd, mmmm, gggg) ir tāda pati nozīme, bet tie attiecas uz Hidžras kalendāru. Formāta simboli paliek angļu valodā; Simboli, kas izraisa teksta attēlošanu (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 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 izmantošana izteiksmēFormatēšanu varat izmantot visur, kur vien var 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 parādīta izteiksme, ko varat izmantot atskaites rekvizītā Filtrs , lai ierobežotu izvadi līdz iepriekšējās nedēļas ierakstiem.

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

Šajā piemērā atskaites ierakstu avotā ir lauks ar nosaukumu Datums, kurā ir katra konkrētā ieraksta modificēšanas datums un kas 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ā 

Šajā piemērā parādīti dažādi funkcijas Format pielietojumi, lai formatētu vērtības, izmantojot gan nosauktus formātus, gan lietotāja definētus formātus. Datuma atdalītājam (/), laika atdalītājam (:) un AM/PM literālim faktiskā formatētā izvade, ko parāda sistēma, ir atkarīga no tā datora lokālajiem iestatījumiem, kurā kods darbojas. Kad laiks un datumi tiek rādīti izstrādes vidē, tiek izmantots koda lokalizācijas saīsinātais laika formāts un īsais datuma formāts. Parādot izpildes kodu, tiek izmantots sistēmas lokalizācijas īsais laika formāts un īsais datuma formāts, kas var atšķirties no koda lokalizācijas. Šajā piemērā tiek pieņemts, ka tā ir ASV angļu valodas lokalizācija.

MyTime un MyDate tiek parādīti izstrādes vidē, izmantojot pašreizējo sistēmas īsā laika iestatījumu un īsā 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 izmantošana ar nulles garuma virknēm

Microsoft Access versijā 2.0 un vecākās versijās funkciju Format var izmantot, lai atgrieztu vienu vērtību nulles garuma virknei un citu vērtību vērtībai. Piemēram, ar funkciju Format var izmantot formāta izteiksmi, piemēram, tālāk norādīto, lai no koda atgrieztu atbilstošu virknes vērtību:

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 Null gadījumam ir jāveic atsevišķa pārbaude un pēc tam atbilstīgā vērtība, pamatojoties uz rezultātu, ir jāatgriež. Piemēram, funkciju IIf var izmantot izteiksmē ar funkciju Format , piemēram, šajā izvēlnē:

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 kopā ar funkciju Format , turpina darboties tāpat kā iepriekšējās versijās.

Ja konvertējat datu bāzi no Microsoft Access 2.0 un vecākas versijas uz Microsoft Access 2002 vai jaunāku versiju, ir jāmaina kods, lai pārbaudītu atsevišķi Null gadījumā.

Virkņu funkcijas un to izmantošana