Freigeben über


Strings.Format(Object, String) Methode

Definition

Gibt eine Zeichenfolge zurück, die gemäß anweisungen formatiert ist, die in einem Format String Ausdruck enthalten sind.

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. Ein beliebiger gültiger Ausdruck.

Style
String

Wahlfrei. Ein gültiges benanntes oder benutzerdefiniertes Format String Ausdrucks.

Gibt zurück

Eine Zeichenfolge, die gemäß anweisungen formatiert ist, die in einem Format String Ausdruck enthalten sind.

Beispiele

Dieses Beispiel zeigt verschiedene Verwendungsmöglichkeiten der Format-Funktion zum Formatieren von Werten mit String Formaten und benutzerdefinierten Formaten. Für das Datumstrennzeichen (/), Zeittrennzeichen (:) und die AM/PM-Indikatoren (t und tt) hängt die tatsächliche formatierte Ausgabe, die von Ihrem System angezeigt wird, von den Gebietsschemaeinstellungen ab, die der Code verwendet. Wenn Uhrzeiten und Datumsangaben in der Entwicklungsumgebung angezeigt werden, werden das kurze Zeitformat und das kurze Datumsformat des Codegebietsschemas verwendet.

Anmerkung

Bei Gebietsschemas, die ein 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 von Stylezu formatieren, bietet die Format-Funktion Funktionen ähnlich wie die Str-Funktion, obwohl sie international bekannt ist. Positive Zahlen, die mit der Format-Funktion formatiert sind, enthalten jedoch kein führendes Leerzeichen, das für das Vorzeichen des Werts reserviert ist; die mit der Str-Funktion konvertierten Personen den führenden Platz beibehalten.

Verschiedene Formate für unterschiedliche numerische Werte

Ein benutzerdefinierter Formatausdruck für Zahlen kann von 1 bis drei Abschnitten durch Semikolons getrennt sein. Wenn das argument Style der funktion Format eines der vordefinierten numerischen Formate enthält, ist nur ein Abschnitt zulässig.

Wenn Sie 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; die zweite gilt für negative Werte.
Drei Abschnitte Der erste Abschnitt gilt für positive Werte, die zweite gilt für negative Werte und das dritte gilt 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 mit nichts dazwischen einfügen, wird der fehlende Abschnitt mit dem Format des positiven Werts gedruckt. Das folgende Format zeigt z. B. positive und negative Werte mithilfe des Formats im ersten Abschnitt an und zeigt Zero an, wenn der Wert null ist.

Dim style2 As String = "$#,##0;;\Z\e\r\o"

Vordefinierte numerische Formate

In der folgenden Tabelle sind die vordefinierten Namen des numerischen Formats angegeben. Diese können anhand des Namens als argument Style für die funktion Format verwendet werden:

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

Beispielsweise gibt Format(&H3FA, "g")1018zurück.
Currency, Coder c Zeigt die Zahl mit Tausendertrennzeichen an, falls zutreffend; zeigt zwei Ziffern rechts neben dem Dezimaltrennzeichen an. Die Ausgabe basiert auf den Systemgebietsschemaeinstellungen.

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

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

Beispielsweise gibt Format(1234567, "n")1,234,567.00zurück.
Percent Zeigt die zahl multipliziert mit 100 mit einem Prozentzeichen (%) an, das unmittelbar rechts angefügt ist; zeigt immer zwei Ziffern rechts neben dem Dezimaltrennzeichen an.

Beispielsweise gibt Format(0.4744, "Percent")47.44%zurück.
Poder p Zeigt die Zahl mit Tausendsteltrennzeichen multipliziert mit 100 mit einem Prozentzeichen (%) an, das rechts angefügt und durch ein einzelnes Leerzeichen getrennt ist; zeigt immer zwei Ziffern rechts neben dem Dezimaltrennzeichen an.

Beispielsweise gibt Format(0.80345, "p")80.35 %zurück.
Scientific Verwendet standardmäßige wissenschaftliche Schreibweise, die zwei signifikante Ziffern bereitstellt.

Beispielsweise gibt Format(1234567, "Scientific")1.23E+06zurück.
Eoder e Verwendet standardmäßige wissenschaftliche Schreibweise, die sechs signifikante Ziffern bereitstellt.

Beispielsweise gibt Format(1234567, "e")1.234567e+006zurück.
Doder d Zeigt die Zahl als Zeichenfolge an, die den Wert der Zahl im Decimal-Format (Basis 10) enthält. Diese Option wird nur für integrale Typen (Byte, Short, Integer, Long) unterstützt.

Beispielsweise gibt Format(&H7F, "d")127zurück.
Xoder x Zeigt die 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.

Beispielsweise gibt Format(127, "x")7fzurück.
Yes/No Zeigt No an, wenn die Zahl 0 ist; andernfalls wird Yesangezeigt.

Beispielsweise gibt Format(0, "Yes/No")Nozurück.
True/False Zeigt False an, wenn die Zahl 0 ist; andernfalls wird Trueangezeigt.

Beispielsweise gibt Format(1, "True/False")Truezurück.
On/Off Zeigt Off an, wenn die Zahl 0 ist; andernfalls wird Onangezeigt.

Beispielsweise gibt Format(1, "On/Off")Onzurück.

Notizen für Smart Device Developer

Die Formate Yes/No, True/Falseund On/Off werden nicht unterstützt.

User-Defined numerische Formate

In der folgenden Tabelle sind Zeichen aufgeführt, die Sie zum Erstellen benutzerdefinierter Zahlenformate verwenden können. Diese können verwendet werden, um das argument Style für die funktion Format zu erstellen:

Zeichen Beschreibung
Nichts Zeigt die Zahl ohne Formatierung an.
(0) Ziffernplatzhalter. Zeigt eine Ziffer oder eine Null 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 enthält als Nullen (auf beiden Seiten des Dezimalzeichens) im Formatausdruck, werden führende oder nachfolgende Nullen angezeigt. Wenn die Zahl rechts neben dem Dezimaltrennzeichen mehr Ziffern enthält, als nullen rechts vom Dezimaltrennzeichen im Formatausdruck vorhanden sind, rundet die Zahl auf so viele Dezimalstellen ab, wie nullen vorhanden sind. Wenn die Zahl links neben dem Dezimaltrennzeichen mehr Ziffern enthält, als nullen links neben dem 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 er 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 enthält, 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; Zahlen, die kleiner als 1 sind, beginnen mit einem Dezimaltrennzeichen. Um eine führende Null anzuzeigen, die mit Bruchzahlen angezeigt wird, verwenden Sie null als ersten Ziffernplatzhalter links neben dem Dezimaltrennzeichen. In einigen Gebietsschemas wird ein Komma als Dezimaltrennzeichen verwendet. Das tatsächliche Zeichen, das als Dezimalplatzhalter in der formatierten Ausgabe verwendet wird, hängt vom vom vom System erkannten Zahlenformat ab. 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 angezeigt wird.
(,) Tausendertrennzeichen. Das Tausendertrennzeichen trennt Tausende von Hunderten innerhalb einer Zahl, die vier oder mehr Stellen links neben dem Dezimaltrennzeichen aufweist. Die Standardverwendung des Tausendertrennzeichens wird angegeben, wenn das Format ein Tausendertrennzeichen enthält, das von Ziffernplatzhaltern umgeben ist (0 oder #).

Ein Tausendertrennzeichen unmittelbar links neben dem Dezimaltrennzeichen (unabhängig davon, ob ein Dezimaltrennzeichen angegeben wird) oder als ganz rechts in der Zeichenfolge bedeutet " die Zahl skalieren, indem sie nach Bedarf durch 1.000 dividiert wird." Zahlen, die kleiner als 1.000, aber größer oder gleich 500 sind, werden als 1angezeigt, und Zahlen, die kleiner als 500 sind, werden als 0angezeigt. Zwei benachbarte Tausendertrennzeichen in dieser Position skalieren um einen Faktor von 1 Million und einen zusätzlichen Faktor von 1.000 für jedes zusätzliche Trennzeichen.

Mehrere Trennzeichen an einer anderen Position als unmittelbar links neben dem Dezimaltrennzeichen oder der ganz rechts in der Zeichenfolge werden einfach als Angabe der Verwendung eines Tausendertrennzeichens behandelt. In einigen Gebietsschemas wird ein Punkt als Tausendertrennzeichen verwendet. Das tatsächliche Zeichen, das als Tausendertrennzeichen in der formatierten Ausgabe verwendet wird, hängt vom von Ihrem System erkannten Zahlenformat ab. Daher sollten Sie das Komma als Tausendertrennzeichen in Ihren Formaten verwenden, auch wenn Sie sich in einem Gebietsschema befinden, das ein 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,.", der die Skalierung um einen Faktor von 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 einigen Gebietsschemas können andere Zeichen verwendet werden, um das Zeittrennzeichen darzustellen. Das Zeittrennzeichen trennt Stunden, Minuten und Sekunden, wenn Zeitwerte formatiert sind. Das tatsächliche Zeichen, das als Zeittrennzeichen in der formatierten Ausgabe verwendet wird, wird durch Ihre Systemeinstellungen bestimmt.
(/) Datumstrennzeichen. In einigen Gebietsschemas können andere Zeichen verwendet werden, um das Datumstrennzeichen darzustellen. Das Datumstrennzeichen trennt tag, monat und jahr, wenn Datumswerte formatiert sind. Das tatsächliche Zeichen, das als Datumstrennzeichen in der formatierten Ausgabe verwendet wird, wird durch Ihre Systemeinstellungen bestimmt.
(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 E oder e wird zwischen der Zahl und dem Exponenten eingefügt. Die Anzahl der Ziffernplatzhalter links bestimmt die Anzahl der Stellen 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. Sie müssen auch Ziffernplatzhalter rechts neben diesem Symbol einfügen, um die richtige Formatierung zu erhalten.
- + $ ( ) Literalzeichen. Diese Zeichen werden genau so angezeigt, wie sie in der Formatzeichenfolge eingegeben wurden. Wenn Sie ein anderes Zeichen als eines der aufgeführten Zeichen anzeigen möchten, stellen Sie ihm einen umgekehrten Schrägstrich (\) voran, oder schließen Sie es in doppelte Anführungszeichen ein (" ").
(\) Zeigt das nächste Zeichen in der Formatzeichenfolge an. Um ein Zeichen anzuzeigen, das eine besondere Bedeutung als Literalzeichen hat, stellen Sie ihm einen umgekehrten Schrägstrich voran (\). Der umgekehrte Schrägstrich selbst wird nicht angezeigt. Die Verwendung eines umgekehrten Schrägstrichs entspricht 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 Zeichen zur Datums- und Uhrzeitformatierung (a, c, d, h, m, n, p, q, s, t, w, y, /und :), die numerischen Formatierungszeichen (#, 0, %, E, e, Komma, und Punkt) und die Zeichenfolgenformatierungszeichen (@, &, <, >und !).
("``ABC``") Zeigt die Zeichenfolge in den doppelten Anführungszeichen an (" "). Um eine Zeichenfolge in das Formatargument aus dem Code einzuschließen, müssen Sie Chr(34) verwenden, um den Text einzuschließen (34 ist der Zeichencode für ein Anführungszeichen (")).

Legacycodebeispiel

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 das argument Style der funktion Format; die anderen Spalten enthalten die resultierende Ausgabe, wenn die formatierten Daten den in den Spaltenüberschriften angegebenen Wert aufweisen.

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 Namen des Datums- und Uhrzeitformats angegeben. Diese können anhand des Namens als Formatvorlagenargument für die funktion Format verwendet werden:

Formatname Beschreibung
General Dateoder G Zeigt ein Datum und/oder eine Uhrzeit an. Beispiel: 3/12/2008 11:07:31 AM. Die Datumsanzeige wird durch den aktuellen Kulturwert Ihrer Anwendung bestimmt.
Long Date, Medium Dateoder D Zeigt ein Datum gemäß dem langen Datumsformat Ihrer aktuellen Kultur an. Beispiel: Wednesday, March 12, 2008.
Short Dateoder d Zeigt ein Datum mit dem kurzen Datumsformat Ihrer aktuellen Kultur an. Beispiel: 3/12/2008.

Das d Zeichen zeigt den Tag in einem benutzerdefinierten Datumsformat an.
Long Time, Medium Timeoder T Zeigt eine Zeit an, die das lange Zeitformat Ihrer aktuellen Kultur verwendet. enthält in der Regel Stunden, Minuten, Sekunden. Beispiel: 11:07:31 AM.
Short Time oder t Zeigt eine Uhrzeit mit dem kurzen Zeitformat Ihrer aktuellen Kultur an. Beispiel: 11:07 AM.

Das t Zeichen zeigt AM oder PM Werte für Gebietsschemas an, die ein 12-Stunden-Format in einem benutzerdefinierten Zeitformat verwenden.
f Zeigt das lange Datum und die kurze Zeit entsprechend dem Format Ihrer aktuellen Kultur an. Beispiel: Wednesday, March 12, 2008 11:07 AM.
F Zeigt das lange Datum und die lange Zeit entsprechend dem Format Ihrer aktuellen Kultur an. Beispiel: Wednesday, March 12, 2008 11:07:31 AM.
g Zeigt das kurze Datum und die kurze Uhrzeit entsprechend dem Format Ihrer aktuellen Kultur an. 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 gemäß der RFC1123Pattern-Eigenschaft. Beispiel: Wed, 12 Mar 2008 11:07:31 GMT. Das formatierte Datum passt den Wert des Datums und der Uhrzeit nicht an. Sie müssen den Datums-/Uhrzeitwert an 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 sortierbarer GMT-Index. Beispiel: 2008-03-12 11:07:31Z.
U Formatiert das Datum und die Uhrzeit mit dem langen Datum und der langen Uhrzeit als GMT. Beispiel: Wednesday, March 12, 2008 6:07:31 PM.
Y, y Formatiert das Datum als Jahr und Monat. Beispiel: March, 2008.

Die zeichen Y und y zeigen das Jahr in einem benutzerdefinierten Datumsformat an.

Weitere Informationen zu den aktuellen Kulturinformationen der Anwendung finden Sie unter How Culture Affects Strings in Visual Basic.

User-Defined Datums-/Uhrzeitformate

Die folgende Tabelle enthält Zeichen, mit deren Hilfe 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 einigen Gebietsschemas können andere Zeichen verwendet werden, um das Zeittrennzeichen darzustellen. Das Zeittrennzeichen trennt Stunden, Minuten und Sekunden, wenn Zeitwerte formatiert sind. Das tatsächliche Zeichen, das als Zeittrennzeichen in formatierter Ausgabe verwendet wird, wird durch den aktuellen Kulturwert Ihrer Anwendung bestimmt.
(/) Datumstrennzeichen. In einigen Gebietsschemas können andere Zeichen verwendet werden, um das Datumstrennzeichen darzustellen. Das Datumstrennzeichen trennt tag, monat und jahr, wenn Datumswerte formatiert sind. Das tatsächliche Zeichen, das als Datumstrennzeichen in formatierter Ausgabe verwendet wird, wird durch die aktuelle Kultur Der Anwendung bestimmt.
(%) Wird verwendet, um anzugeben, dass das folgende Zeichen ohne Bezug auf nachfolgende Buchstaben als Einbuchstabenformat gelesen werden sollte. 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 vorangestellte Null an (z. B. 1). Verwenden Sie %d, wenn dies das einzige Zeichen im benutzerdefinierten zahlenformat ist.
dd Zeigt den Tag als Zahl mit vorangestellter 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 vorangestellte Null an (z. B. Januar wird als 1dargestellt). Verwenden Sie %M, wenn dies das einzige Zeichen im benutzerdefinierten zahlenformat ist.
MM Zeigt den Monat als Zahl mit vorangestellter 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 Zeichenfolge für Punkt/Zeit (z. B. A.D.) an.
h Zeigt die Stunde als Zahl ohne führende Nullen mit dem 12-Stunden-Format an (z. B. 1:15:15 PM). Verwenden Sie %h, wenn dies das einzige Zeichen im benutzerdefinierten zahlenformat ist.
hh Zeigt die Stunde als Zahl mit führenden Nullen mit dem 12-Stunden-Format 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 im benutzerdefinierten zahlenformat ist.
HH Zeigt die Stunde als Zahl mit führenden Nullen mit 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 im benutzerdefinierten zahlenformat 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 an (z. B. 12:15:5). Verwenden Sie %s, wenn dies das einzige Zeichen im benutzerdefinierten zahlenformat ist.
ss Zeigt die Zweite als Zahl mit führenden Nullen an (z. B. 12:15:05).
f Zeigt Bruchzahlen von Sekunden an. Beispielsweise zeigt ff Hundertstel Sekunden an, während ffff zehntausendstel Sekunden anzeigt. Sie können bis zu sieben f Symbole in Ihrem benutzerdefinierten Format verwenden. Verwenden Sie %f, wenn dies das einzige Zeichen im benutzerdefinierten zahlenformat ist.
t Verwendet das 12-Stunden-Format und zeigt eine großgeschriebene A für jede Stunde vor Mittag an; zeigt eine großgeschriebene P für jede Stunde zwischen Mittag und 11:59 Uhr an. Verwenden Sie %t, wenn dies das einzige Zeichen im benutzerdefinierten Zahlenformat ist.
tt Zeigt für Gebietsschemas, die ein 12-Stunden-Format verwenden, eine großgeschriebene AM mit jeder Stunde vor Mittag an. zeigt eine großgeschriebene PM mit jeder Stunde zwischen Mittag und 11:59 Uhr an.

Bei Gebietsschemas, die ein 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 zahlenformat ist.
yy Zeigt das Jahr im zweistelligen Zahlenformat mit vorangestellter Null an, falls zutreffend.
yyy Zeigt das Jahr im vierstelligen Zahlenformat an.
yyyy Zeigt das Jahr im vierstelligen Zahlenformat an.
z Zeigt den Zeitzonenoffset ohne vorangestellte Null an (z. B. -8). Verwenden Sie %z, wenn dies das einzige Zeichen im benutzerdefinierten zahlenformat ist.
zz Zeigt den Zeitzonenoffset mit einer führenden Null an (z. B. -08)
zzz Zeigt den Offset für die vollständige Zeitzone an (z. B. -08:00)

Legacycodebeispiel

Im Folgenden sind Beispiele für benutzerdefinierte Datums- und Uhrzeitformate für December 7, 1958, 8:50 PM, 35 secondsaufgeführt:

Format Zeigt
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 für Smart Device Developer

Die Mindestzeitauflö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