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. 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 Stylezu 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 StyleFormat 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 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, 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, 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, , ShortInteger, 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, , ShortInteger, 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/NoFormate , True/Falseund 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 1angezeigt, und Zahlen kleiner als 500 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" 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, dctqsmpyw/nhund :), die numerischen Formatierungszeichen (#, %eE0kommas 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 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 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 1dargestellt). 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