Funktion formatieren
Gibt eine Variante ( String ) zurück, die einen Ausdruck enthält, der gemäß den in einem Formatausdruck enthaltenen Anweisungen formatiert ist.
Warnung Bei der Verwendung dieser Funktion ist ein Problem aufgetreten. Der letzte Montag in einigen Kalenderjahren kann als Woche 53 zurückgegeben werden, obwohl es Woche 1 sein sollte. Weitere Informationen und eine Problemumgehung finden Sie unter Format oder DatePart-Funktionen können für den letzten Montag im Jahr eine falsche Wochennummer zurückgeben . |
Syntax
Format( Ausdruck [ , Format ] [ , ErsterTagderWoche ] [ , ErsteWochedesJahres ] )
Die Syntax der Funktion Format hat die folgenden Argumente:
Streit | Beschreibung |
Ausdruck | Erforderlich. Jeder gültige Ausdruck. |
Format | Optional. Ein gültiger benannter oder benutzerdefinierter Formatausdruck. |
erster Tag der Woche | Optional. Eine Konstante, die den ersten Tag der Woche angibt. |
erste Woche des Jahres | Optional. Eine Konstante, die die erste Woche des Jahres angibt. |
Einstellungen
Das Formatargument kann abhängig vom Datentyp des Ausdrucksarguments eine Vielzahl von Einstellungen verwenden. Weitere Informationen zu gültigen Formatausdrücken finden Sie in den in der folgenden Tabelle aufgeführten Artikeln.
Für Ausdrücke, die diesen Datentyp verwenden... | Siehe Artikel |
Jeder Typ | |
Terminzeit | |
Numerisch | |
Text und Notiz | |
Ja Nein |
Das Argument firstdayofweek hat diese Einstellungen:
Konstante | Wert | Beschreibung |
vbUseSystem | 0 | Verwenden Sie die NLS-API-Einstellung. |
VbSonntag | 1 | Sonntag (Standard) |
vbMontag | 2 | Montag |
vbDienstag | 3 | Dienstag |
vbMittwoch | 4 | Mittwoch |
vbDonnerstag | 5 | Donnerstag |
vbFreitag | 6 | Freitag |
vbSamstag | 7 | Samstag |
Das Argument firstweekofyear hat diese Einstellungen:
Konstante | Wert | Beschreibung |
vbUseSystem | 0 | Verwenden Sie die NLS-API-Einstellung. |
vbFirstJan1 | 1 | Beginnen Sie mit der Woche, in der der 1. Januar liegt (Standard). |
vbFirstFourDays | 2 | Beginnen Sie mit der ersten Woche, die mindestens vier Tage im Jahr hat. |
vbErsteVolleWoche | 3 | Beginnen Sie mit der ersten vollen Woche des Jahres. |
Bemerkungen
Formatieren | Mach das |
Zahlen | Verwenden Sie vordefinierte benannte numerische Formate oder erstellen Sie benutzerdefinierte numerische Formate. |
Daten und Zeiten | Verwenden Sie vordefinierte benannte Datums-/Zeitformate oder erstellen Sie benutzerdefinierte Datums-/Zeitformate. |
Seriennummern für Datum und Uhrzeit | Verwenden Sie Datums- und Zeitformate oder numerische Formate. |
Saiten | Erstellen Sie Ihre eigenen benutzerdefinierten Zeichenfolgenformate. |
Wenn Sie versuchen, eine Zahl zu formatieren, ohne format anzugeben, bietet Format ähnliche Funktionen wie die Str -Funktion, obwohl sie international bekannt ist. Positive Zahlen, die mit Format als Zeichenfolgen formatiert wurden, enthalten jedoch kein führendes Leerzeichen, das für das Vorzeichen des Werts reserviert ist. diejenigen, die mit Str konvertiert wurden, behalten das führende Leerzeichen bei.
Wenn Sie eine nicht lokalisierte numerische Zeichenfolge formatieren, sollten Sie ein benutzerdefiniertes numerisches Format verwenden, um sicherzustellen, dass Sie das gewünschte Aussehen erhalten.
Hinweis: Wenn die Einstellung der Kalendereigenschaft Gregorianisch ist und format die Datumsformatierung angibt, muss der angegebene Ausdruck Gregorianisch sein. Wenn die Eigenschaftseinstellung des Visual Basic -Kalenders Hijri ist, muss der bereitgestellte Ausdruck Hijri sein.
Wenn der Kalender gregorianischen ist, bleibt die Bedeutung der Formatausdruckssymbole unverändert. Wenn der Kalender Hijri ist, haben alle Datumsformatsymbole (z. B. tttt, mmmm, jjjj) dieselbe Bedeutung, gelten aber für den Hijri-Kalender. Formatsymbole bleiben in Englisch; Symbole, die zu einer Textanzeige führen (z. B. AM und PM), zeigen die diesem Symbol zugeordnete Zeichenfolge (Englisch oder Arabisch) an. Der Bereich bestimmter Symbole ändert sich, wenn der Kalender Hijri ist.
Symbol | Bereich |
d | 1-30 |
dd | 1-30 |
ww | 1-51 |
mmm | Zeigt vollständige Monatsnamen an (Hijri-Monatsnamen haben keine Abkürzungen). |
j | 1-355 |
jjjj | 100-9666 |
Beispiele
Verwenden der Format-Funktion in einem Ausdruck Sie können Format überall dort verwenden, wo Sie Ausdrücke verwenden können. Sie können es beispielsweise in einer Abfrage als Teil eines Feldaliasnamens oder in der Eigenschaft „Steuerelementquelle" eines Textfelds in einem Formular oder Bericht verwenden. Das folgende Beispiel zeigt einen Ausdruck, den Sie in der Filtereigenschaft eines Berichts verwenden können, um die Ausgabe auf Datensätze der Vorwoche zu beschränken.
Format([Datum],"ww")=Format(Jetzt(),"ww")-1
In diesem Beispiel hat die Datensatzquelle des Berichts ein Feld mit dem Namen „Datum", das das Datum enthält, an dem jeder einzelne Datensatz geändert wurde, und das im Bericht verwendet wird. Wenn Sie den Bericht ausführen, werden seine Ergebnisse gefiltert, um nur die Datensätze anzuzeigen, bei denen die Woche für den Wert im Datumsfeld (Format([Datum],"ww")) gleich der vorherigen Woche ist (Format(Now(), "ww")-1).
Verwenden Sie die Formatfunktion im VBA-Code
Hinweis: Die folgenden Beispiele veranschaulichen die Verwendung dieser Funktion in einem Visual Basic for Applications (VBA)-Modul. Um weitere Informationen zum Arbeiten mit VBA zu erhalten, wählen Sie Entwicklerreferenz in der Dropdown-Liste neben Suchen aus und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
Dieses Beispiel zeigt verschiedene Verwendungen der Format -Funktion zum Formatieren von Werten, indem sowohl benannte Formate als auch benutzerdefinierte Formate verwendet werden. Für das Datumstrennzeichen ( / ), das Zeittrennzeichen ( : ) und das AM/PM-Literal hängt die tatsächliche formatierte Ausgabe, die von Ihrem System angezeigt wird, von den Gebietsschemaeinstellungen des Computers ab, auf dem der Code ausgeführt wird. Wenn Zeiten und Daten in der Entwicklungsumgebung angezeigt werden, werden das kurze Zeitformat und das kurze Datumsformat des Codegebietsschemas verwendet. Bei der Anzeige durch Ausführen von Code werden das kurze Zeitformat und das kurze Datumsformat des Systemgebietsschemas verwendet, die sich vom Codegebietsschema unterscheiden können. Für dieses Beispiel wird das Gebietsschema US-Englisch angenommen.
MyTime und MyDate werden in der Entwicklungsumgebung mit der aktuellen Systemkurzzeiteinstellung und Kurzdatumseinstellung angezeigt.
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".
Verwenden von Format mit Zeichenfolgen der Länge null
In Microsoft Access, Version 2.0 und früher, konnten Sie die Format -Funktion verwenden, um einen Wert für eine leere Zeichenfolge und einen anderen für einen Wert zurückzugeben. Sie könnten beispielsweise einen Formatausdruck wie den folgenden mit der Funktion Format verwenden, um den entsprechenden Zeichenfolgenwert aus dem Code zurückzugeben:
Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")
In Microsoft Access-Versionen 97 und höher müssen Sie den Nullfall separat testen und dann den entsprechenden Wert basierend auf dem Ergebnis zurückgeben. Beispielsweise könnten Sie die IIf -Funktion in einem Ausdruck mit der Format -Funktion wie dem folgenden verwenden:
varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))
Diese Änderung gilt nur, wenn Sie die Format -Funktion verwenden, um eine Zeichenfolge abhängig davon zu formatieren, ob es sich um eine leere Zeichenfolge oder einen Nullwert handelt. Andere Formatausdrücke, die mit der Funktion Format verwendet werden, funktionieren weiterhin wie in früheren Versionen.
Wenn Sie eine Datenbank von Microsoft Access, Version 2.0 oder früher, in Microsoft Access 2002 oder höher konvertieren, müssen Sie den Code ändern, um den Nullfall separat zu testen.
No comments:
Post a Comment