Strings.Format(Object, String) Methode

Definition

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. Jeder gültige Ausdruck.

Style
String

Dies ist optional. Ein gültiger benannter oder benutzerdefinierter Format-String-Ausdruck.

Gibt zurück

String

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 das gewünschte Aussehen angezeigt wird.

Wenn Sie versuchen, eine Zahl ohne Angabe zu formatieren Style, bietet die Format Funktion Funktionen wie die Str Funktion, obwohl sie international bekannt ist. Positive Zahlen, die als Zeichenfolgen mit der Format Funktion formatiert sind, enthalten jedoch kein führendes Leerzeichen, das für das Zeichen des Werts reserviert ist; die mit der Str Funktion konvertierten Werte behalten den führenden Leerraum bei.

Verschiedene 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 enthält zwei Abschnitte: Das erste definiert das Format für positive Werte und Nullen; Der zweite Abschnitt definiert das Format für negative Werte. Da das Style Argument der Format Funktion eine Zeichenfolge verwendet, wird sie durch 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. Das folgende Format zeigt beispielsweise positive und negative Werte mithilfe des Formats im ersten Abschnitt an und zeigt an Zero , ob der Wert null 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 Namen als Style Argument für die Format Funktion verwendet werden:

Formatname BESCHREIBUNG
General Number, Goder g Zeigt die Zahl ohne Tausendertrennzeichen an.

Format(&H3FA, "g") gibt beispielsweise 1018 zurück.
Currency, Coder c Zeigt die Zahl mit Tausendertrennzeichen an, falls zutreffend; zeigt zwei Ziffern rechts neben dem Dezimaltrennzeichen an. Die Ausgabe hängt vom verwendeten Systemgebietsschema ab.

Format(1234567, "c") gibt beispielsweise $1,234,567.00 zurück.
Fixed, Foder f Zeigt mindestens eine Ziffer links und zwei Ziffern rechts vom Dezimaltrennzeichen an.

Format(1234567, "f") gibt beispielsweise 1234567.00 zurück.
Standard, Noder n Zeigt die Zahl mit Tausendertrennzeichen an, mindestens eine Ziffer links und zwei Ziffern rechts neben dem Dezimaltrennzeichen.

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 Zeigt No an, ob die Zahl 0 ist; andernfalls wird angezeigt Yes.

Format(0, "Yes/No") gibt beispielsweise No zurück.
True/False Zeigt False an, ob die Zahl 0 ist; andernfalls wird angezeigt True.

Format(1, "True/False") gibt beispielsweise True zurück.
On/Off Zeigt Off an, ob die Zahl 0 ist; andernfalls wird angezeigt On.

Format(1, "On/Off") gibt beispielsweise On zurück.

Notizen zu Smart Device Developer

Die Yes/NoFormate True/False, und On/Off Formate 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 in 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 in der Position aufweist, an der das # Zeichen in der Formatzeichenfolge angezeigt wird, zeigt es an. Andernfalls wird nichts an dieser Position angezeigt.

Dieses Symbol funktioniert wie der 0 Ziffernplatzhalter, außer dass führende und nachgestellte Nullen nicht angezeigt werden, wenn die Zahl weniger Ziffern aufweist als # zeichen auf einer seite des Dezimaltrennzeichens im Formatausdruck.
(.) 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; Zahlen, die kleiner als 1 sind, beginnen 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 unmittelbar links vom Dezimaltrennzeichen (unabhängig davon, ob eine Dezimalstelle angegeben ist) oder als Zeichen ganz rechts in der Zeichenfolge skaliert die Zahl, indem sie durch 1.000 dividiert und nach Bedarf gerundet wird. Zahlen, die kleiner als 1.000 sind, aber größer oder gleich 500 sind, werden als 1angezeigt, und Zahlen, die kleiner als 500 sind, werden als 0angezeigt. 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.000" zu formatieren.
- "#0,.", der die Skalierung um einen Faktor von 1 Tausend verwendet, um die Zahl 100 Millionen als Zeichenfolge "100000" zu formatieren.
- "#,0,.", das das Tausendertrennzeichen und die Skalierung um eintausend 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 mindestens einen Ziffernplatzhalter (0 oder #) links neben E+``e-``E-, , oder e+, enthält, wird die Zahl im wissenschaftlichen Format angezeigt und oder e wird zwischen der Zahl und E dem Exponenten eingefügt. Die Anzahl der Ziffernplatzhalter auf der linken Seite bestimmt die Anzahl der Ziffern im Exponenten. Verwenden oder e- platzieren Sie E- ein Minuszeichen neben negativen Exponenten. Verwenden oder e+ platzieren Sie E+ ein Minuszeichen neben negativen Exponenten und einem Pluszeichen neben positiven Exponenten. 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 Datumsformatierungs- und Zeitformatierungszeichen (, , p``d``m``h``n``s``q``y``:``/``w``tund ), die numerischen Formatierungszeichen (, e``E``%``0``cKomma und Punkt) und die Zeichenfolgenformatierungszeichen@``&``<``> (a``#, und ).!
("``ABC``") Zeigt die Zeichenfolge innerhalb der doppelten Anführungszeichen (" ") an. Um eine Zeichenfolge in das Formatformatargument aus Code einzuschließen, müssen Chr(34) Sie den Text einschließen (34 ist der Zeichencode für ein Anführungszeichen (").

Legacy-Codebeispiel

Die folgende Tabelle enthält einige Beispielformatausdrücke für Zahlen. (In diesen Beispielen wird davon ausgegangen, dass die Gebietsschemaeinstellung Ihres Systems englisch-US ist) Die erste Spalte enthält die Formatzeichenfolgen für Style das Argument der Format Funktion; die anderen Spalten enthalten die resultierende Ausgabe, wenn die formatierten Daten den wert in den Spaltenüberschriften angegeben haben.

Format (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. Dies kann nach Dem Namen als Formatvorlageargument 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 Dateoder 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 Timeoder 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 Wert "Datum/Uhrzeit" 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 Zeichen und y Zeichen Y zeigen das Jahr in einem benutzerdefinierten Datumsformat an.

Weitere Informationen zu den aktuellen Kulturinformationen der Anwendung finden Sie unter "Auswirkungen 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 sind diese Formatzeichen groß- und kleinschreibungsempfindlich.

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 1. B. ). Verwenden Sie %d , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
dd Zeigt den Tag als Zahl mit einer führenden Null an (z 01. B. ).
ddd Zeigt den Tag als Abkürzung an (z Sun. B. ).
dddd Zeigt den Tag als vollständiger Name an (z Sunday. B. ).
M Zeigt den Monat als Zahl ohne führende Null an (z. B. Januar wird als 1Zahl dargestellt). Verwenden Sie %M , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
MM Zeigt den Monat als Zahl mit einer führenden Null an (z 01/12/01. B. ).
MMM Zeigt den Monat als Abkürzung an (z Jan. B. ).
MMMM Zeigt den Monat als vollständigen Monatsnamen an (z January. B. ).
gg Zeigt die Zeichenfolge "Period/Era" an (z A.D.. B. ).
h Zeigt die Stunde als Zahl ohne führende Nullen mit der 12-Stunden-Uhr an (z 1:15:15 PM. B. ). Verwenden Sie %h , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
hh Zeigt die Stunde als Zahl mit führenden Nullen mit der 12-Stunden-Uhr an (z 01:15:15 PM. B. ).
H Zeigt die Stunde als Zahl ohne führende Nullen mit der 24-Stunden-Uhr an (z 1:15:15. B. ). Verwenden Sie %H , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
HH Zeigt die Stunde als Zahl mit führenden Nullen mit der 24-Stunden-Uhr an (z 01:15:15. B. ).
m Zeigt die Minute als Zahl ohne führende Nullen an (z 12:1:15. B. ). Verwenden Sie %m , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
mm Zeigt die Minute als Zahl mit führenden Nullen an (z 12:01:15. B. ).
s Zeigt die Zweite als Zahl ohne führende Nullen an (z 12:15:5. B. ). Verwenden Sie %s , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
ss Zeigt die Zweite als Zahl mit führenden Nullen an (z 12:15:05. B. ).
f Zeigt Sekundenbruchteile an. Zeigt beispielsweise ff Hunderte von Sekunden an, während ffff zehntausend Sekunden angezeigt werden. Sie können bis zu sieben f Symbole im benutzerdefinierten Format verwenden. Verwenden Sie %f , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
t Verwendet die 12-Stunden-Uhr und zeigt einen Großbuchstaben A für jede Stunde vor Dem Mittag an. Zeigt eine Großbuchstaben P für jede Stunde zwischen 11:59 P.M an. Verwenden Sie %t , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
tt Für Gebietsschemas, die eine 12-Stunden-Uhr verwenden, wird ein Großbuchstaben mit jeder Stunde vor Noon angezeigt; zeigt eine Großbuchstaben AM PM mit einer beliebigen Stunde zwischen Demon und 11:59 P.M 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 im 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 Timezone-Offset ohne eine führende Null an (z -8. B. ). Verwenden Sie %z , wenn dies das einzige Zeichen im benutzerdefinierten numerischen Format ist.
zz Zeigt den Timezone-Offset mit einer führenden Null (z. B. -08) an.
zzz Zeigt den Vollzeitzone-Offset (z. B. -08:00) an.

Legacy-Codebeispiel

Im Folgenden sind 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

Notizen zum Smart Device-Entwickler

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 Formatzeichen 0 zurück, wenn er f auf diesem Gerät ausgeführt wird.

Gilt für

Siehe auch