Strings.Format(Object, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt eine Zeichenfolge zurück, die entsprechend den Anweisungen in einem String
-Formatausdruck formatiert ist.
public static string Format (object? Expression, string? Style = "");
public static string Format (object Expression, string Style = "");
static member Format : obj * string -> string
Public Function Format (Expression As Object, Optional Style As String = "") As String
Parameter
- Expression
- Object
Erforderlich. Beliebiger gültiger Ausdruck.
- Style
- String
Dies ist optional. Ein gültiger benannter oder benutzerdefinierter Format-String
-Ausdruck.
Gibt zurück
Eine Zeichenfolge, die entsprechend den Anweisungen in einem String
-Formatausdruck formatiert ist.
Beispiele
Dieses Beispiel zeigt verschiedene Verwendungsmöglichkeiten der Format
-Funktion zur Formatierung von Werten mit String
-Formaten und benutzerdefinierten Formaten. Die tatsächlich von Ihrem System ausgegebene Formatierung von Datumstrennzeichen (/
), Trennzeichen für Zeitangaben (:
) und AM/PM-Indikatoren (t
und tt
) richtet sich nach den Gebietsschemaeinstellungen des Codes. Wenn Datums- und Zeitangaben in der Entwicklungsumgebung angezeigt werden, werden das 24-Stunden-Zeitformat und das kurze Datumsformat des für den Code ausgewählten Gebietsschemas verwendet.
Hinweis
Für Gebietsschemas, die das 24-Stunden-Format verwenden, zeigen die AM/PM-Indikatoren (t
und tt
) nichts an.
Dim testDateTime As Date = #1/27/2001 5:04:23 PM#
Dim testStr As String
' Returns current system time in the system-defined long time format.
testStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
testStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date
' format, using the single letter code for the format.
testStr = Format(Now(), "D")
' Returns the value of testDateTime in user-defined date/time formats.
' Returns "5:4:23".
testStr = Format(testDateTime, "h:m:s")
' Returns "05:04:23 PM".
testStr = Format(testDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
testStr = Format(testDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
testStr = Format(testDateTime, "HH:mm:ss")
' Returns "23".
testStr = Format(23)
' User-defined numeric formats.
' Returns "5,459.40".
testStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
testStr = Format(334.9, "###0.00")
' Returns "500.00%".
testStr = Format(5, "0.00%")
Hinweise
Die String.Format -Methode bietet auch ähnliche Funktionen.
Wenn Sie eine nicht lokalisierte numerische Zeichenfolge formatieren, sollten Sie ein benutzerdefiniertes numerisches Format verwenden, um sicherzustellen, dass Sie das gewünschte Aussehen erhalten.
Wenn Sie versuchen, eine Zahl ohne Angabe Style
zu formatieren, bietet die Format
Funktion eine Ähnliche Funktionalität wie die Str
Funktion, obwohl sie international bekannt ist. Positive Zahlen, die als Zeichenfolgen formatiert werden, die die Format
Funktion verwenden, enthalten jedoch keinen führenden Platz, der für das Zeichen des Werts reserviert ist. Die mit der Str
Funktion konvertierten Zahlen behalten den führenden Leerraum.
Unterschiedliche Formate für unterschiedliche numerische Werte
Ein benutzerdefinierter Formatausdruck für Zahlen kann einen bis drei durch Semikolons getrennte Abschnitte aufweisen. Wenn das Style
Argument der Format
Funktion eines der vordefinierten numerischen Formate enthält, ist nur ein Abschnitt zulässig.
Bei Verwendung von | Dies ist das Ergebnis: |
---|---|
Nur ein Abschnitt | Der Formatausdruck gilt für alle Werte. |
Zwei Abschnitte | Der erste Abschnitt gilt für positive Werte und Nullen. Der zweite Abschnitt gilt für negative Werte. |
Drei Abschnitte | Der erste Abschnitt gilt für positive Werte, der zweite für negative Werte und der dritte für Nullen. |
Das folgende Beispiel umfasst zwei Abschnitte: Der erste definiert das Format für positive Werte und Nullen; Im zweiten Abschnitt wird das Format für negative Werte definiert. Da das Style
Argument der Format
Funktion eine Zeichenfolge annimmt, wird es in Anführungszeichen eingeschlossen.
Dim style1 As String = "$#,##0;($#,##0)"
Wenn Sie Semikolons ohne Inhalt dazwischen einfügen, wird der fehlende Abschnitt im Format des positiven Werts ausgegeben. Im folgenden Format werden beispielsweise positive und negative Werte mit dem Format im ersten Abschnitt und angezeigt Zero
, wenn der Wert 0 ist.
Dim style2 As String = "$#,##0;;\Z\e\r\o"
Vordefinierte numerische Formate
In der folgenden Tabelle sind die Namen der vordefinierten numerischen Formate aufgeführt. Diese können nach Name als Argument für die Style
Format
Funktion verwendet werden:
Formatname | BESCHREIBUNG |
---|---|
General Number , G oder g |
Zeigt die Zahl ohne Tausendertrennzeichen an.Format(&H3FA, "g") gibt beispielsweise 1018 zurück. |
Currency , C oder c |
Zeigt die Zahl ggf. mit Tausendertrennzeichen an. zeigt rechts neben dem Dezimaltrennzeichen zwei Ziffern an. Die Ausgabe hängt vom verwendeten Systemgebietsschema ab.Format(1234567, "c") gibt beispielsweise $1,234,567.00 zurück. |
Fixed , F oder f |
Zeigt mindestens eine Ziffer links und zwei Ziffern rechts vom Dezimaltrennzeichen an.Format(1234567, "f") gibt beispielsweise 1234567.00 zurück. |
Standard , N oder n |
Zeigt die Zahl mit Tausendertrennzeichen, mindestens eine Ziffer links und zwei Ziffern rechts neben dem Dezimaltrennzeichen an.Format(1234567, "n") gibt beispielsweise 1,234,567.00 zurück. |
Percent |
Zeigt eine Zahl multipliziert mit 100 mit einem unmittelbar rechts angefügten Prozentzeichen (%) an; es werden stets zwei Ziffern rechts vom Dezimaltrennzeichen angezeigt.Format(0.4744, "Percent") gibt beispielsweise 47.44% zurück. |
P oder p |
Zeigt die Zahl mit Tausendertrennzeichen multipliziert mit 100 mit einem Prozentzeichen (%) an, das rechts angefügt und durch ein Leerzeichen abgetrennt wird; zeigt immer zwei Ziffern rechts vom Dezimaltrennzeichen an.Format(0.80345, "p") gibt beispielsweise 80.35 % zurück. |
Scientific |
Verwendet die standardmäßige wissenschaftliche Schreibweise und stellt zwei signifikante Stellen bereit.Format(1234567, "Scientific") gibt beispielsweise 1.23E+06 zurück. |
E oder e |
Verwendet die standardmäßige wissenschaftliche Schreibweise und stellt sechs signifikante Stellen bereit.Format(1234567, "e") gibt beispielsweise 1.234567e+006 zurück. |
D oder d |
Zeigt eine Zahl als Zeichenfolge an, die den Wert der Zahl im Dezimalformat (Basis 10) enthält. Diese Option wird nur für integrale Typen (Byte , , Short Integer , Long ) unterstützt.Format(&H7F, "d") gibt beispielsweise 127 zurück. |
X oder x |
Zeigt eine Zahl als Zeichenfolge an, die den Wert der Zahl im Hexadezimalformat (Basis 16) enthält. Diese Option wird nur für integrale Typen (Byte , , Short Integer , Long ) unterstützt.Format(127, "x") gibt beispielsweise 7f zurück. |
Yes/No |
Wird angezeigt No , wenn zahl 0 ist, andernfalls wird angezeigt Yes .Format(0, "Yes/No") gibt beispielsweise No zurück. |
True/False |
Wird angezeigt False , wenn zahl 0 ist, andernfalls wird angezeigt True .Format(1, "True/False") gibt beispielsweise True zurück. |
On/Off |
Wird angezeigt Off , wenn zahl 0 ist, andernfalls wird angezeigt On .Format(1, "On/Off") gibt beispielsweise On zurück. |
Entwicklerhinweise zu intelligenten Geräten
Die Yes/No
Formate , True/False
und On/Off
werden nicht unterstützt.
User-Defined numerische Formate
In der folgenden Tabelle sind die Zeichen aufgeführt, mit denen Sie benutzerdefinierte Zahlenformate erstellen können. Diese können verwendet werden, um das Style
Argument für die Format
Funktion zu erstellen:
Zeichen | BESCHREIBUNG |
---|---|
Keine | Zeigt die Zahl ohne Formatierung an. |
(0 ) |
Ziffernplatzhalter. Zeigt eine Ziffer oder eine Null (0) an. Wenn der Ausdruck eine Ziffer an der Position aufweist, an der die Null in der Formatzeichenfolge angezeigt wird, zeigen Sie ihn an; andernfalls wird an dieser Position eine Null angezeigt. Wenn die Zahl weniger Ziffern hat, als Nullen (auf beiden Seiten des Dezimaltrennzeichens) im Formatausdruck vorhanden sind, werden führende oder nachfolgende Nullen (0) angezeigt. Wenn die Zahl rechts vom Dezimaltrennzeichen mehr Ziffern aufweist, als Nullen (0) rechts vom Dezimaltrennzeichen im Formatausdruck vorhanden sind, wird die Zahl auf so viele Dezimalstellen gerundet, wie Nullen vorhanden sind. Wenn die Zahl links vom Dezimaltrennzeichen mehr Ziffern aufweist, als Nullen (0) links vom Dezimaltrennzeichen im Formatausdruck vorhanden sind, werden die zusätzlichen Ziffern ohne Änderung angezeigt. |
(# ) |
Ziffernplatzhalter. Zeigt eine Ziffer oder nichts an. Wenn der Ausdruck eine Ziffer an der Position aufweist, an der das # Zeichen in der Formatzeichenfolge angezeigt wird, wird es angezeigt, andernfalls wird an dieser Position nichts angezeigt.Dieses Symbol funktioniert wie der 0 Ziffernplatzhalter, mit der Ausnahme, dass führende und nachfolgende Nullen nicht angezeigt werden, wenn die Zahl weniger Ziffern aufweist, als Zeichen auf beiden Seiten des Dezimaltrennzeichens im Formatausdruck vorhanden sind # . |
(. ) |
Dezimalplatzhalter. Der Dezimalplatzhalter bestimmt, wie viele Ziffern links und rechts vom Dezimaltrennzeichen angezeigt werden. Wenn der Formatausdruck nur # Zeichen links neben diesem Symbol enthält, beginnen Zahlen kleiner als 1 mit einem Dezimaltrennzeichen. Verwenden Sie Null (0) als ersten Ziffernplatzhalter links vom Dezimaltrennzeichen, um eine führende Null mit Bruchzahlen anzuzeigen. In manchen Gebietsschemata wird ein Komma als Dezimaltrennzeichen verwendet. Welches Zeichen tatsächlich in der formatierten Ausgabe als Dezimaltrennzeichen verwendet wird, hängt von dem Zahlenformat ab, das Ihr System erkennt. Daher sollten Sie den Punkt als Dezimalplatzhalter in Ihren Formaten verwenden, auch wenn Sie sich in einem Gebietsschema befinden, das ein Komma als Dezimalplatzhalter verwendet. Die formatierte Zeichenfolge wird im richtigen Format für das Gebietsschema angezeigt. |
(% ) |
Prozentplatzhalter. Multipliziert den Ausdruck mit 100. Das Prozentzeichen (% ) wird an der Position eingefügt, an der es in der Formatzeichenfolge auftritt. |
(, ) |
Tausendertrennzeichen. Das Tausendertrennzeichen trennt Tausende von Hundertern in einer Zahl, die links vom Dezimaltrennzeichen vier oder mehr Stellen aufweist. Die Standardverwendung des Tausendertrennzeichens wird angegeben, wenn das Format ein Tausendertrennzeichen enthält, das von Ziffernplatzhaltern (0 oder # ) umgeben ist.Ein Tausendertrennzeichen direkt links neben dem Dezimaltrennzeichen (unabhängig davon, ob ein Dezimalzeichen angegeben ist oder nicht) oder als rechtsstes Zeichen in der Zeichenfolge bedeutet "die Zahl skalieren, indem sie durch 1.000 dividiert wird, nach Bedarf rundet." Zahlen, die kleiner als 1.000, aber größer oder gleich 500 sind, werden als 1 angezeigt, und Zahlen kleiner als 500 werden als 0 angezeigt. Zwei benachbarte Tausendertrennzeichen an dieser Position skalieren mit dem Faktor 1 Million und einem zusätzlichen Faktor von 1.000 für jedes weitere Trennzeichen.Mehrere benachbarte Trennzeichen an jeder anderen Position als unmittelbar links vom Dezimaltrennzeichen oder an der Position ganz rechts in der Zeichenfolge werden einfach als Angabe der Verwendung eines Tausendertrennzeichens behandelt. In manchen Gebietsschemata wird ein Punkt als Tausendertrennzeichen verwendet. Welches Zeichen tatsächlich in der formatierten Ausgabe als Tausendertrennzeichen verwendet wird, hängt von dem Zahlenformat ab, das Ihr System erkennt. Daher sollten Sie das Komma als Tausendertrennzeichen in Ihren Formaten verwenden, auch wenn Sie sich in einem Gebietsschema befinden, das einen Punkt als Tausendertrennzeichen verwendet. Die formatierte Zeichenfolge wird im richtigen Format für das Gebietsschema angezeigt. Betrachten Sie beispielsweise die drei folgenden Formatzeichenfolgen: - "#,0." , das das Tausendertrennzeichen verwendet, um die Zahl 100 Millionen als Zeichenfolge "100.000.000" zu formatieren.- "#0,." , bei der die Skalierung um den Faktor 10000 verwendet wird, um die Zahl 100 Millionen als Zeichenfolge "100000" zu formatieren.- "#,0,." , das das Tausendertrennzeichen und die Skalierung um tausend verwendet, um die Zahl 100 Millionen als Zeichenfolge "100.000" zu formatieren. |
(: ) |
Zeittrennzeichen. In manchen Gebietsschemata können andere Zeichen verwendet werden, um das Zeittrennzeichen darzustellen. Das Zeittrennzeichen trennt Stunden, Minuten und Sekunden, wenn Zeitwerte formatiert werden. Welches Zeichen tatsächlich in der formatierten Ausgabe als Zeittrennzeichen verwendet wird, hängt von den Systemeinstellungen ab. |
(/ ) |
Datumstrennzeichen. In manchen Gebietsschemata können andere Zeichen verwendet werden, um das Datumstrennzeichen darzustellen. Das Datumstrennzeichen trennt Tag, Monat und Jahr, wenn Datumswerte formatiert werden. Welches Zeichen tatsächlich in der formatierten Ausgabe als Datumstrennzeichen verwendet wird, hängt von den Systemeinstellungen ab. |
(E-``E+``e-``e+ ) |
Wissenschaftliches Format. Wenn der Formatausdruck links von E- , , E+ e+ e- oder mindestens einen Ziffernplatzhalter (0 oder # ) enthält, wird die Zahl im wissenschaftlichen Format angezeigt und E oder e zwischen der Zahl und ihrem Exponenten eingefügt. Die Anzahl der Ziffernplatzhalter auf der linken Seite bestimmt die Anzahl der Ziffern im Exponenten. Verwenden Sie E- oder e- , um ein Minuszeichen neben negativen Exponenten zu platzieren. Verwenden Sie E+ oder e+ , um ein Minuszeichen neben negativen Exponenten und ein Pluszeichen neben positiven Exponenten zu platzieren. Außerdem müssen Sie rechts neben diesem Symbol eine Ziffer als Platzhalter einfügen, um eine korrekte Formatierung zu erhalten. |
- + $ ( ) |
Literalzeichen. Diese Zeichen werden genau so angezeigt, wie sie in der Formatzeichenfolge eingegeben werden. Um ein anderes Zeichen als eines der aufgelisteten anzuzeigen, stellen Sie ihm einen umgekehrten Schrägstrich voran (\ ) oder setzen Sie es in doppelte Anführungszeichen (" "). |
(\ ) |
Zeigt das nächste Zeichen in der Formatzeichenfolge an. Um ein Zeichen anzuzeigen, das eine besondere Bedeutung als literales Zeichen hat, stellen Sie ihm einen umgekehrten Schrägstrich (\ ) voran. Der umgekehrte Schrägstrich selbst wird nicht angezeigt. Das Verwenden des umgekehrten Schrägstrichs ist gleichbedeutend mit dem Einschließen des nächsten Zeichens in doppelte Anführungszeichen. Um einen umgekehrten Schrägstrich anzuzeigen, verwenden Sie zwei umgekehrte Schrägstriche (\\ ).Beispiele für Zeichen, die nicht als Literalzeichen angezeigt werden können, sind die Datums- und Zeitformatierungszeichen ( a , d c t q s m p y w / n h und : ), die numerischen Formatierungszeichen (# , % e E 0 kommas und punkt) und die Zeichenfolgenformatierungszeichen (@ , & , < , > , und ).! |
("``ABC``" ) |
Zeigt die Zeichenfolge innerhalb der doppelten Anführungszeichen (" ") an. Um eine Zeichenfolge aus dem Code in das Stilargument einzuschließen, müssen Chr(34) Sie verwenden, um den Text einzuschließen (34 ist der Zeichencode für ein Anführungszeichen (")). |
Legacy-Codebeispiel
Die folgende Tabelle enthält einige Beispielformatausdrücke für Zahlen. (Diese Beispiele gehen alle davon aus, dass die Gebietsschemaeinstellung Ihres Systems Englisch-USA ist.) Die erste Spalte enthält die Formatzeichenfolgen für das Style
Argument der Format
Funktion. Die anderen Spalten enthalten die resultierende Ausgabe, wenn die formatierten Daten den in den Spaltenüberschriften angegebenen Wert aufweisen.
Formatieren (Style ) |
„5“ formatiert als | „-5“ formatiert als | „0.5“ formatiert als |
---|---|---|---|
Zero-length string ("") |
5 |
-5 |
0.5 |
0 |
5 |
-5 |
1 |
0.00 |
5.00 |
-5.00 |
0.50 |
#,##0 |
5 |
-5 |
1 |
$#,##0;($#,##0) |
$5 |
($5) |
$1 |
$#,##0.00;($#,##0.00) |
$5.00 |
($5.00) |
$0.50 |
0% |
500% |
-500% |
50% |
0.00% |
500.00% |
-500.00% |
50.00% |
0.00E+00 |
5.00E+00 |
-5.00E+00 |
5.00E-01 |
0.00E-00 |
5.00E00 |
-5.00E00 |
5.00E-01 |
Vordefinierte Datums-/Uhrzeitformate
In der folgenden Tabelle sind die vordefinierten Datums- und Uhrzeitformate aufgeführt. Diese können nach Name als Stilargument für die Format
Funktion verwendet werden:
Formatname | BESCHREIBUNG |
---|---|
General Date oder G |
Zeigt ein Datum und/oder eine Uhrzeit an. Beispiel: 3/12/2008 11:07:31 AM . Die Datumsanzeige wird durch den aktuellen Wert Ihrer Anwendung für die Kultur bestimmt. |
Long Date , Medium Date oder D |
Datumsanzeige gemäß dem Format für langes Datum Ihrer Kultur. Beispiel: Wednesday, March 12, 2008 . |
Short Date oder d |
Datumsanzeige gemäß dem Format für kurzes Datum Ihrer Kultur. Beispiel: 3/12/2008 .Das d Zeichen zeigt den Tag in einem benutzerdefinierten Datumsformat an. |
Long Time , Medium Time oder T |
Uhrzeitanzeige gemäß dem Format für lange Uhrzeit Ihrer Kultur, umfasst meist Stunden, Minuten und Sekunden. Beispiel: 11:07:31 AM . |
Short Time oder t |
Zeigt eine Uhrzeit an, indem das kurze Uhrzeitformat Ihrer aktuellen Kultureinstellung verwendet wird. Beispiel: 11:07 AM .Das t Zeichen zeigt AM oder PM Werte für Gebietsschemas an, die eine 12-Stunden-Uhr in einem benutzerdefinierten Zeitformat verwenden. |
f |
Zeigt das lange Datum und die kurze Uhrzeit an, indem das Format Ihrer aktuellen Kultureinstellung verwendet wird. Beispiel: Wednesday, March 12, 2008 11:07 AM . |
F |
Zeigt das lange Datum und die lange Uhrzeit an, indem das Format Ihrer aktuellen Kultureinstellung verwendet wird. Beispiel: Wednesday, March 12, 2008 11:07:31 AM . |
g |
Zeigt das kurze Datum und die kurze Uhrzeit an, indem das Format Ihrer aktuellen Kultureinstellung verwendet wird. Beispiel: 3/12/2008 11:07 AM . |
M , m |
Zeigt den Monat und den Tag eines Datums an. Beispiel: March 12 .Das M Zeichen zeigt den Monat in einem benutzerdefinierten Datumsformat an. Das m Zeichen zeigt die Minuten in einem benutzerdefinierten Zeitformat an. |
R , r |
Formatiert das Datum entsprechend der RFC1123Pattern -Eigenschaft. Beispiel: Wed, 12 Mar 2008 11:07:31 GMT . Das formatierte Datum passt dabei nicht den Wert des Datums und der Uhrzeit an. Sie müssen den Datum/Uhrzeit-Wert auf GMT anpassen, bevor Sie die Format Funktion aufrufen. |
s |
Formatiert das Datum und die Uhrzeit als sortierbaren Index. Beispiel: 2008-03-12T11:07:31 .Das s Zeichen zeigt die Sekunden in einem benutzerdefinierten Zeitformat an. |
u |
Formatiert das Datum und die Uhrzeit als sortierbaren GMT-Index. Beispiel: 2008-03-12 11:07:31Z . |
U |
Formatiert das Datum und die Uhrzeit jeweils im langen GMT-Format. Beispiel: Wednesday, March 12, 2008 6:07:31 PM . |
Y , y |
Formatiert das Datum als Jahr und Monat. Beispiel: March, 2008 .Die Y Zeichen und y zeigen das Jahr in einem benutzerdefinierten Datumsformat an. |
Weitere Informationen zu den aktuellen Kulturinformationen der Anwendung finden Sie unter Auswirkungen der Kultur auf Zeichenfolgen in Visual Basic.
User-Defined Datums-/Uhrzeitformate
In der folgenden Tabelle sind die Zeichen aufgeführt, mit denen Sie benutzerdefinierte Datums-/Uhrzeitformate erstellen können. Im Gegensatz zu früheren Versionen von Visual Basic wird bei diesen Formatzeichen die Groß-/Kleinschreibung beachtet.
Zeichen | BESCHREIBUNG |
---|---|
(: ) |
Zeittrennzeichen. In manchen Gebietsschemata können andere Zeichen verwendet werden, um das Zeittrennzeichen darzustellen. Das Zeittrennzeichen trennt Stunden, Minuten und Sekunden, wenn Zeitwerte formatiert werden. Welches Zeichen tatsächlich in der formatierten Ausgabe als Zeittrennzeichen verwendet wird, hängt vom aktuellen Kulturwerte der Anwendung ab. |
(/ ) |
Datumstrennzeichen. In manchen Gebietsschemata können andere Zeichen verwendet werden, um das Datumstrennzeichen darzustellen. Das Datumstrennzeichen trennt Tag, Monat und Jahr, wenn Datumswerte formatiert werden. Welches Zeichen tatsächlich in der formatierten Ausgabe als Datumstrennzeichen verwendet wird, hängt von der aktuellen Kultur der Anwendung ab. |
(% ) |
Wird verwendet, um anzugeben, dass das folgende Zeichen ohne Berücksichtigung nachstehender Buchstaben als Einzelbuchstabenformat gelesen werden soll. Wird auch verwendet, um anzugeben, dass ein Einzelbuchstabenformat als benutzerdefiniertes Format gelesen wird. Weitere Informationen finden Sie im Folgenden. |
d |
Zeigt den Tag als Zahl ohne führende Null an (z. B 1 . ). Verwenden Sie %d , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
dd |
Zeigt den Tag als Zahl mit einer führenden Null an (z. B. 01 ). |
ddd |
Zeigt den Tag als Abkürzung an (z. B. Sun ). |
dddd |
Zeigt den Tag als vollständigen Namen an (z. B. Sunday ). |
M |
Zeigt den Monat als Zahl ohne führende Null an (z. B. wird Januar als 1 dargestellt). Verwenden Sie %M , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
MM |
Zeigt den Monat als Zahl mit einer führenden Null an (z. B 01/12/01 . ). |
MMM |
Zeigt den Monat als Abkürzung an (z. B. Jan ). |
MMMM |
Zeigt den Monat als vollständigen Monatsnamen an (z. B. January ). |
gg |
Zeigt die Perioden-/Epochenzeichenfolge an (z. B. A.D. ). |
h |
Zeigt die Stunde als Zahl ohne führende Nullen mit der 12-Stunden-Uhr an (z. B 1:15:15 PM . ). Verwenden Sie %h , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
hh |
Zeigt die Stunde als Zahl mit führenden Nullen unter Verwendung der 12-Stunden-Uhr an (z. B 01:15:15 PM . ). |
H |
Zeigt die Stunde als Zahl ohne führende Nullen mit der 24-Stunden-Uhr an (z. B 1:15:15 . ). Verwenden Sie %H , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
HH |
Zeigt die Stunde als Zahl mit führenden Nullen unter Verwendung der 24-Stunden-Uhr an (z. B 01:15:15 . ). |
m |
Zeigt die Minute als Zahl ohne führende Nullen an (z. B 12:1:15 . ). Verwenden Sie %m , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
mm |
Zeigt die Minute als Zahl mit führenden Nullen an (z. B 12:01:15 . ). |
s |
Zeigt die zweite Als Zahl ohne führende Nullen (z. B. 12:15:5 ) an. Verwenden Sie %s , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
ss |
Zeigt die zweite Als Zahl mit führenden Nullen (z. B. 12:15:05 ) an. |
f |
Zeigt Sekundenbruchteile an. Zeigt z. B ff . hundertstel Sekunden an, während ffff zehntausendstel Sekunden angezeigt werden. Sie können bis zu sieben f Symbole in Ihrem benutzerdefinierten Format verwenden. Verwenden Sie %f , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
t |
Verwendet die 12-Stunden-Uhr und zeigt eine Großbuchstaben A für jede Stunde vor Mittag an. Zeigt einen Großbuchstaben P für jede Stunde zwischen 11:59 Uhr und 23:59 Uhr an. Verwenden Sie %t , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
tt |
Für Gebietsschemas, die eine 12-Stunden-Uhr verwenden, wird ein Großbuchstaben AM mit einer beliebigen Stunde vor Mittag angezeigt. Zeigt eine Großbuchstaben PM mit einer beliebigen Stunde zwischen Mittag und 23:59 Uhr an.Für Gebietsschemas, die das 24-Stunden-Format verwenden, wird nichts angezeigt. |
y |
Zeigt die Jahreszahl (0-9) ohne führende Nullen an. Verwenden Sie %y , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
yy |
Zeigt das Jahr im zweistelligen Zahlenformat ggf. mit einer führenden Null an. |
yyy |
Zeigt das Jahr in einem vierstelligen Zahlenformat an. |
yyyy |
Zeigt das Jahr in einem vierstelligen Zahlenformat an. |
z |
Zeigt den Zeitzonenoffset ohne führende Null (z. B -8 . ) an. Verwenden Sie %z , wenn dies das einzige Zeichen in Ihrem benutzerdefinierten numerischen Format ist. |
zz |
Zeigt den Zeitzonenoffset mit einer führenden Null an (z. B. -08 ) |
zzz |
Zeigt den gesamten Zeitzonenoffset an (z. B. -08:00 ) |
Legacy-Codebeispiel
Es folgen Beispiele für benutzerdefinierte Datums- und Uhrzeitformate für December 7, 1958, 8:50 PM, 35 seconds
:
Format | Anzeige |
---|---|
M/d/yy |
12/7/58 |
d-MMM |
7-Dec |
d-MMMM-yy |
7-December-58 |
d MMMM |
7 December |
MMMM yy |
December 58 |
hh:mm tt |
08:50 PM |
h:mm:ss t |
8:50:35 P |
H:mm |
20:50 |
H:mm:ss |
20:50:35 |
M/d/yyyy H:mm |
12/7/1958 20:50 |
Entwicklerhinweise zu intelligenten Geräten
Die minimale Zeitauflösung für ein Gerät wird vom Hersteller des Geräts bestimmt. Wenn die Zeitauflösung für das Gerät grob genug ist, gibt das f
Formatzeichen 0 zurück, wenn es auf diesem Gerät ausgeführt wird.
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für