Strings.Format(Object, String) Metoda

Definicja

Zwraca ciąg sformatowany zgodnie z instrukcjami zawartymi w wyrażeniu formatu String .

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

Parametry

Expression
Object

Wymagane. Dowolne prawidłowe wyrażenie.

Style
String

Opcjonalny. Prawidłowe wyrażenie formatu String nazwanego lub zdefiniowanego przez użytkownika.

Zwraca

Ciąg sformatowany zgodnie z instrukcjami zawartymi w wyrażeniu formatu String .

Przykłady

W tym przykładzie przedstawiono różne zastosowania Format funkcji do formatowania wartości przy użyciu formatów zdefiniowanych przez String użytkownika i formatów zdefiniowanych przez użytkownika. W przypadku separatora dat (), separatora czasu (/:) oraz wskaźników AM/PM (t i tt) rzeczywiste sformatowane dane wyjściowe wyświetlane przez system zależą od ustawień regionalnych używanych przez kod. Gdy godziny i daty są wyświetlane w środowisku projektowym, używany jest format krótkiego czasu i format daty krótkiej ustawień regionalnych kodu.

Uwaga

W przypadku ustawień regionalnych, które używają zegara 24-godzinnego, wskaźniki AM/PM (t i tt) nie wyświetlają nic.

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%")

Uwagi

Metoda String.Format zapewnia również podobną funkcjonalność.

Jeśli formatujesz nielokalizowany ciąg liczbowy, należy użyć formatu liczbowego zdefiniowanego przez użytkownika, aby upewnić się, że uzyskasz odpowiedni wygląd.

Jeśli próbujesz sformatować liczbę bez określenia Style, Format funkcja zapewnia funkcjonalność podobną do Str funkcji, chociaż jest ona świadoma na arenie międzynarodowej. Jednak liczby dodatnie sformatowane jako ciągi korzystające z Format funkcji nie zawierają spacji wiodącej zarezerwowanej dla znaku wartości. Te przekonwertowane przy użyciu Str funkcji zachowują przestrzeń wiodącą.

Różne formaty dla różnych wartości liczbowych

Zdefiniowane przez użytkownika wyrażenie formatu dla liczb może zawierać od jednej do trzech sekcji rozdzielonych średnikami. Style Jeśli argument Format funkcji zawiera jeden ze wstępnie zdefiniowanych formatów liczbowych, dozwolona jest tylko jedna sekcja.

Jeśli używany element to To jest wynik
Tylko jedna sekcja Wyrażenie formatu dotyczy wszystkich wartości.
Dwie sekcje Pierwsza sekcja dotyczy wartości dodatnich i zer; druga dotyczy wartości ujemnych.
Trzy sekcje Pierwsza sekcja dotyczy wartości dodatnich, druga dotyczy wartości ujemnych, a trzecia dotyczy zer.

Poniższy przykład zawiera dwie sekcje: pierwszy definiuje format wartości dodatnich i zer; druga sekcja definiuje format wartości ujemnych. Style Ponieważ argument Format funkcji przyjmuje ciąg, jest on ujęta w cudzysłów.

Dim style1 As String = "$#,##0;($#,##0)"

W przypadku uwzględnienia średników bez żadnych elementów między nimi brakująca sekcja jest wyświetlana przy użyciu formatu wartości dodatniej. Na przykład poniższy format wyświetla wartości dodatnie i ujemne przy użyciu formatu w pierwszej sekcji i wyświetla Zero , jeśli wartość ma wartość zero.

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

Wstępnie zdefiniowane formaty liczbowe

W poniższej tabeli zidentyfikowano wstępnie zdefiniowane nazwy formatów liczbowych. Mogą one być używane przez nazwę jako Style argument funkcji Format :

Nazwa formatu Opis
General Number, Glub g Wyświetla liczbę bez separatora tysięcy.

Na przykład Format(&H3FA, "g") zwraca wartość 1018.
Currency, Club c Wyświetla liczbę z separatorem tysięcy, jeśli jest to odpowiednie; wyświetla dwie cyfry po prawej stronie separatora dziesiętnego. Dane wyjściowe zależą od ustawień regionalnych systemu.

Na przykład Format(1234567, "c") zwraca wartość $1,234,567.00.
Fixed, Flub f Wyświetla co najmniej jedną cyfrę z lewej i dwie cyfry z prawej strony separatora dziesiętnego.

Na przykład Format(1234567, "f") zwraca wartość 1234567.00.
Standard, Nlub n Wyświetla liczbę z separatorem tysięcy, co najmniej jedną cyfrę po lewej stronie i dwie cyfry po prawej stronie separatora dziesiętnego.

Na przykład Format(1234567, "n") zwraca wartość 1,234,567.00.
Percent Wyświetla liczby pomnożone przez 100 ze znakiem procentu (%) dołączonym od razy po prawej stronie; po prawej stronie separatora dziesiętnego wyświetla zawsze dwie cyfry.

Na przykład Format(0.4744, "Percent") zwraca wartość 47.44%.
P lub p Wyświetla liczbę z separatorem tysięcznym pomnożonym przez 100 z znakiem procentowym (%) dołączonym do prawej i oddzielonej pojedynczą spacją; zawsze wyświetla dwie cyfry po prawej stronie separatora dziesiętnego.

Na przykład Format(0.80345, "p") zwraca wartość 80.35 %.
Scientific Używa standardowej notacji naukowej, która udostępnia dwie znaczące cyfry.

Na przykład Format(1234567, "Scientific") zwraca wartość 1.23E+06.
E lub e Używa standardowej notacji naukowej, zapewniając sześć cyfr znaczących.

Na przykład Format(1234567, "e") zwraca wartość 1.234567e+006.
D lub d Wyświetla liczbę jako ciąg zawierający wartość liczby w formacie dziesiętnym (podstawowym 10). Ta opcja jest obsługiwana tylko w przypadku typów całkowitych (Byte, Short, Integer, Long).

Na przykład Format(&H7F, "d") zwraca wartość 127.
X lub x Wyświetla liczbę jako ciąg zawierający wartość liczby w formacie szesnastkowym (base 16). Ta opcja jest obsługiwana tylko w przypadku typów całkowitych (Byte, Short, Integer, Long).

Na przykład Format(127, "x") zwraca wartość 7f.
Yes/No Wyświetla No , czy liczba to 0; w przeciwnym razie wyświetla Yeswartość .

Na przykład Format(0, "Yes/No") zwraca wartość No.
True/False Wyświetla False , czy liczba to 0; w przeciwnym razie wyświetla Truewartość .

Na przykład Format(1, "True/False") zwraca wartość True.
On/Off Wyświetla Off , czy liczba to 0; w przeciwnym razie wyświetla Onwartość .

Na przykład Format(1, "On/Off") zwraca wartość On.

Uwagi dla deweloperów inteligentnych urządzeń

Formaty Yes/No, True/Falsei On/Off nie są obsługiwane.

Zdefiniowane przez użytkownika formaty liczbowe

W poniższej tabeli zidentyfikowano znaki, których można użyć do tworzenia formatów liczbowych zdefiniowanych przez użytkownika. Mogą one służyć do kompilowania argumentu StyleFormat dla funkcji:

Znak Opis
Brak Wyświetlanie liczby bez formatowania.
(0) Symbol zastępczy cyfry. Wyświetla cyfrę lub zero. Jeśli wyrażenie ma cyfrę w miejscu, w którym zero pojawia się w ciągu formatu, wyświetl je; w przeciwnym razie wyświetla zero w tej pozycji.

Jeśli liczba ma mniej cyfr niż zer (po obu stronach separatora dziesiętnego) w wyrażeniu formatu, są wyświetlane zera wiodące lub końcowe. Jeśli liczba ma więcej cyfr po prawej stronie separatora dziesiętnego niż zer po prawej części separatora dziesiętnego w wyrażeniu formatu, zaokrąglij liczbę do tylu miejsc dziesiętnych, ile jest zer. Jeśli liczba ma więcej cyfr po lewej stronie separatora dziesiętnego niż zer po prawej części separatora dziesiętnego w wyrażeniu formatu, dodatkowe cyfry są wyświetlane bez modyfikacji.
(#) Symbol zastępczy cyfry. Wyświetla cyfrę lub nie wyświetla żadnego elementu. Jeśli wyrażenie ma cyfrę w pozycji, w której # znak pojawia się w ciągu formatu, wyświetla go; w przeciwnym razie nie wyświetla nic w tej pozycji.

Ten symbol działa podobnie jak 0 symbol zastępczy cyfry, z wyjątkiem tego, że zera wiodące i końcowe nie są wyświetlane, jeśli liczba ma mniej cyfr niż znaki # po obu stronach separatora dziesiętnego w wyrażeniu formatu.
(.) Symbol zastępczy liczby dziesiętnej. Symbol zastępczy liczby dziesiętnej określa liczbę cyfr wyświetlanych po lewej i prawej stronie separatora dziesiętnego. Jeśli wyrażenie formatu zawiera tylko # znaki po lewej stronie tego symbolu; liczby mniejsze niż 1 zaczynają się od separatora dziesiętnego. Aby wyświetlić zero wiodące wyświetlane z liczbami ułamkowymi, należy użyć zera jako pierwszego symbolu zastępczego cyfry z lewej strony separatora dziesiętnego. W niektórych ustawieniach regionalnych jako separator dziesiętny jest używany przecinek. Faktyczny znak używany jako dziesiętny symbol zastępczy w sformatowanym danych wyjściowych zależy od formatu liczbowego rozpoznawanego przez system. W tym celu należy użyć kropki jako symbolu zastępczego dziesiętnego w formatach, nawet jeśli używasz ustawień regionalnych, które stosują przecinek jako symbolu zastępczego liczby dziesiętnej. Sformatowany ciąg będzie wyświetlany w formacie prawidłowym dla ustawień regionalnych.
(%) Symbol zastępczy procentu. Mnoży wyrażenie przez 100. Znak procentu ( % ) zostanie wstawiony w miejscu, gdzie pojawia się on w ciągu formatu.
(,) Separator tysięcy. Separator tysięcy oddziela tysiące od setek w obrębie liczby, która ma cztery lub więcej miejsc z lewej strony separatora dziesiętnego. Standardowe użycie separatora tysięcy jest określone, jeśli format zawiera separator tysięcy otoczony symbolami zastępczymi cyfry (0 lub #).

Separator tysięcy natychmiast po lewej stronie separatora dziesiętnego (bez względu na to, czy jest określony dziesiętny) lub jako najbardziej prawy znak w ciągu oznacza "przeskalowanie liczby przez podzielenie jej przez 1000, zaokrąglenie zgodnie z potrzebami". Liczby mniejsze niż 1000, ale większe lub równe 500 są wyświetlane jako 1, a liczby mniejsze niż 500 są wyświetlane jako 0. Dwa sąsiadujące separatory tysięcy w tym miejscu są skalowane przy użyciu współczynnika 1 mln i dodatkowy współczynnik 1000 dla każdego dodatkowego separatora.

Wiele separatorów w dowolnym miejscu innym niż bezpośrednio po lewej stronie separatora dziesiętnego lub w położeniu najdalej po prawej są traktowane po prostu jako wskazanie konieczności użycia separatora tysięcy. W przypadku niektórych ustawień regionalnych jako separator tysięcy jest używana kropka. Faktyczny znak używany jako separator tysięcy w sformatowanym danych wyjściowych zależy od formatu liczbowego rozpoznawanego przez system. W tym celu należy użyć przecinka jako separatora tysięcy w formatach, nawet jeśli używasz ustawień regionalnych, które stosują kropkę jako separator tysięcy. Sformatowany ciąg będzie wyświetlany w formacie prawidłowym dla ustawień regionalnych.

Rozważmy na przykład trzy następujące ciągi formatu:

- "#,0.", który używa separatora tysięcy do formatowania liczby 100 milionów jako ciągu "100 000 000".
- "#0,.", który używa skalowania według współczynnika jednego tysiąca, aby sformatować liczbę 100 milionów jako ciąg "100000".
- "#,0,.", który używa separatora tysięcy i skalowania o jeden tysiąc, aby sformatować liczbę 100 milionów jako ciąg "100 000".
(:) Separator godziny. W przypadku niektórych ustawień regionalnych do reprezentowania separatora godziny mogą być używane inne znaki. Separator godziny oddziela godziny, minuty i sekundy podczas formatowania wartości czasu. Faktyczny znak używany jako separator godziny w sformatowanych danych wyjściowych jest określany na podstawie ustawień systemu.
(/) Separator daty. W przypadku niektórych ustawień regionalnych do reprezentowania separatora daty mogą być używane inne znaki. Separator daty oddziela dzień, miesiąc i rok podczas formatowania wartości dat. Faktyczny znak używany jako separator daty w sformatowanych danych wyjściowych jest określany na podstawie ustawień systemu.
(E-``E+``e-``e+) Format naukowy. Jeśli wyrażenie formatu zawiera co najmniej jeden symbol zastępczy cyfry (0 lub #) z lewej E-strony , E+, e-lub e+, liczba jest wyświetlana w formacie naukowym i E lub e jest wstawiana między liczbą a wykładnikiem. Liczba symboli zastępczych cyfr po lewej stronie określa liczbę cyfr w wykładniku. Użyj polecenia E- lub e- , aby umieścić znak minus obok wykładników ujemnych. Użyj lub E+e+ , aby umieścić znak minus obok wykładników ujemnych i znak plus obok dodatnich wykładników. W celu uzyskania poprawnego formatowania należy również dołączyć symbole zastępcze cyfr z prawej strony tego symbolu.
-+$ ( ) Znaki literału. Te znaki są wyświetlane dokładnie tak, jak wpisano je w ciągu formatu. Aby wyświetlić znak inny niż jeden z wymienionych powyżej, poprzedź go ukośnikiem odwrotnym (\) lub umieść go w podwójnym cudzysłowie (" ").
(\) Wyświetla następny znak w ciągu formatu. Aby wyświetlić znak, który ma specjalne znaczenie jako znak literału, poprzedź go ukośnikiem odwrotnym (\). Sam ukośnik odwrotny nie jest wyświetlany. Użycie ukośnika odwrotnego ma taki sam efekt jak umieszczenie następnego znaku w podwójnym cudzysłowie. Aby wyświetlić ukośnik odwrotny, użyj dwóch ukośników odwrotnych (\\).

Przykłady znaków, których nie można wyświetlić jako znaków literału, to znaki formatowania daty i formatowania czasu (a, c, dynsmwt/hqpi :), znaki formatowania liczbowego (#, 0%, E, , , eprzecinek i kropka) oraz znaki formatowania ciągu (@, &, <, >, i ).!
("``ABC``") Wyświetla ciąg w podwójnym cudzysłowie (" "). Aby uwzględnić ciąg w argumencie stylu z wewnątrz kodu, należy użyć Chr(34) metody , aby ująć tekst (34 to kod znaku dla cudzysłowu (")).

Przykład starszego kodu

Poniższa tabela zawiera przykładowe wyrażenia formatu liczb. (W tych przykładach przyjęto założenie, że ustawienia regionalne systemu to angielski-USA) Pierwsza kolumna zawiera ciągi formatu argumentu StyleFormat funkcji. Pozostałe kolumny zawierają wynikowe dane wyjściowe, jeśli sformatowane dane mają wartość podaną w nagłówkach kolumn.

Format (Style) „5” sformatowane jako „-5” sformatowane jako „0,5” sformatowane jako
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

Wstępnie zdefiniowane formaty daty/godziny

W poniższej tabeli podano nazwy wstępnie zdefiniowanych formatów daty i godziny. Mogą one być używane przez nazwę jako argument stylu dla Format funkcji:

Nazwa formatu Opis
General Date lub G Wyświetla datę i/lub godzinę. Na przykład 3/12/2008 11:07:31 AM. Sposób wyświetlania dat zależy od bieżącej wartości kultury w aplikacji.
Long Date, Medium Datelub D Wyświetla datę zgodnie z formatem daty długiej bieżącej kultury. Na przykład Wednesday, March 12, 2008.
Short Date lub d Wyświetla datę zgodnie z formatem daty krótkiej bieżącej kultury. Na przykład 3/12/2008.

Znak d wyświetla dzień w formacie daty zdefiniowanej przez użytkownika.
Long Time, Medium Timelub T Wyświetla godzinę przy użyciu formatu godziny długiej bieżącej kultury — zazwyczaj obejmuje godziny, minuty i sekundy. Na przykład 11:07:31 AM.
Short Time lub t Wyświetla czas przy użyciu krótkiego formatu czasu bieżącej kultury. Na przykład 11:07 AM.

Znak t wyświetla AM lub PM wartości ustawień regionalnych, które używają zegara 12-godzinnego w formacie czasu zdefiniowanego przez użytkownika.
f Wyświetla datę długą i godzinę krótką zgodnie z formatem bieżącej kultury. Na przykład Wednesday, March 12, 2008 11:07 AM.
F Wyświetla datę i czas długi zgodnie z formatem bieżącej kultury. Na przykład Wednesday, March 12, 2008 11:07:31 AM.
g Wyświetla datę krótką i krótką zgodnie z formatem bieżącej kultury. Na przykład 3/12/2008 11:07 AM.
M, m Wyświetla miesiąc i dzień daty. Na przykład March 12.

Znak M wyświetla miesiąc w formacie daty zdefiniowanej przez użytkownika. Znak m wyświetla minuty w formacie czasu zdefiniowanego przez użytkownika.
R, r Formatuje datę zgodnie z właściwością RFC1123Pattern . Na przykład Wed, 12 Mar 2008 11:07:31 GMT. Sformatowana data nie dostosowuje wartości daty i godziny. Przed wywołaniem Format funkcji należy dostosować wartość Daty/godziny do GMT.
s Formatuje datę i godzinę jako indeks do sortowania. Na przykład 2008-03-12T11:07:31.

Znak s wyświetla sekundy w formacie czasu zdefiniowanego przez użytkownika.
u Formatuje datę i godzinę jako indeks sortowalny GMT. Na przykład 2008-03-12 11:07:31Z.
U Formatuje datę i godzinę z datą długą i godziną o długości czasu GMT. Na przykład Wednesday, March 12, 2008 6:07:31 PM.
Y, y Formatuje datę jako rok i miesiąc. Na przykład March, 2008.

Znaki Y i y wyświetlają rok w formacie daty zdefiniowanej przez użytkownika.

Aby uzyskać więcej informacji na temat bieżącej kultury aplikacji, zobacz How Culture Affects Strings in Visual Basic (Jak kultura wpływa na ciągi w języku Visual Basic).

Zdefiniowane przez użytkownika formaty daty/godziny

W poniższej tabeli przedstawiono znaki, których można użyć do tworzenia formatów daty/godziny zdefiniowanych przez użytkownika. W przeciwieństwie do wcześniejszych wersji języka Visual Basic, w tych znakach formatu jest rozróżniana wielkość liter.

Znak Opis
(:) Separator godziny. W przypadku niektórych ustawień regionalnych do reprezentowania separatora godziny mogą być używane inne znaki. Separator godziny oddziela godziny, minuty i sekundy podczas formatowania wartości czasu. Faktyczny znak używany jako separator godziny w sformatowanych danych wyjściowych jest określany na podstawie bieżącej wartości kultury aplikacji.
(/) Separator daty. W przypadku niektórych ustawień regionalnych do reprezentowania separatora daty mogą być używane inne znaki. Separator daty oddziela dzień, miesiąc i rok podczas formatowania wartości dat. Faktyczny znak używany jako separator daty w sformatowanych danych wyjściowych jest określany na podstawie bieżącej kultury aplikacji.
(%) Służy do wskazywania, że następny znak powinien być odczytany w formacie pojedynczej litery, bez względu na litery końcowe. Służy również do wskazywania, że format pojedynczej litery jest odczytywany jako format zdefiniowany przez użytkownika. Więcej informacji można znaleźć w poniższych sekcjach.
d Wyświetla dzień jako liczbę bez zera wiodącego (na przykład 1). Użyj, %d jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
dd Wyświetla dzień jako liczbę z zerem wiodącym (na przykład 01).
ddd Wyświetla dzień jako skrót (na przykład Sun).
dddd Wyświetla dzień jako pełną nazwę (na przykład Sunday).
M Wyświetla miesiąc jako liczbę bez zera wiodącego (na przykład styczeń jest reprezentowany jako 1). Użyj, %M jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
MM Wyświetla miesiąc jako liczbę z zerem wiodącym (na przykład 01/12/01).
MMM Wyświetla miesiąc jako skrót (na przykład Jan).
MMMM Wyświetla miesiąc jako pełną nazwę miesiąca (na przykład January).
gg Wyświetla ciąg kropki/ery (na przykład A.D.).
h Wyświetla godzinę jako liczbę bez zer wiodących przy użyciu zegara 12-godzinnego (na przykład 1:15:15 PM). Użyj, %h jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
hh Wyświetla godzinę jako liczbę z wiodącymi zerami przy użyciu zegara 12-godzinnego (na przykład 01:15:15 PM).
H Wyświetla godzinę jako liczbę bez zer wiodących przy użyciu zegara 24-godzinnego (na przykład 1:15:15). Użyj, %H jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
HH Wyświetla godzinę jako liczbę z wiodącymi zerami przy użyciu zegara 24-godzinnego (na przykład 01:15:15).
m Wyświetla minutę jako liczbę bez zer wiodących (na przykład 12:1:15). Użyj, %m jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
mm Wyświetla minutę jako liczbę z wiodącymi zerami (na przykład 12:01:15).
s Wyświetla sekundę jako liczbę bez zer wiodących (na przykład 12:15:5). Użyj, %s jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
ss Wyświetla drugi jako liczbę z wiodącymi zerami (na przykład 12:15:05).
f Wyświetla ułamki sekund. Na przykład ff wyświetla setki sekund, natomiast ffff wyświetla dziesięć tysięcznych sekund. W formacie zdefiniowanym przez użytkownika można użyć maksymalnie siedmiu f symboli. Użyj, %f jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
t Używa zegara 12-godzinnego i wyświetla wielkie litery A dla każdej godziny przed południem; wyświetla wielkie litery P dla każdej godziny od południa do 11:59. Użyj %t , jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
tt W przypadku ustawień regionalnych korzystających z zegara 12-godzinnego wyświetla wielkie litery AM z dowolną godziną przed południem; wyświetla wielkie litery PM z dowolną godziną od południa do 11:59 pm.

W przypadku ustawień regionalnych, które używają zegara 24-godzinnego, nie wyświetla niczego.
y Wyświetla numer roku (0–9) bez zer wiodących. Użyj, %y jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
yy Wyświetla rok w dwucyfrowym formacie liczbowym z wiodącym zerem, jeśli ma to zastosowanie.
yyy Wyświetla rok w czterocyfrowym formacie liczbowym.
yyyy Wyświetla rok w czterocyfrowym formacie liczbowym.
z Wyświetla przesunięcie strefy czasowej bez zera wiodącego (na przykład -8). Użyj, %z jeśli jest to jedyny znak w formacie liczbowym zdefiniowanym przez użytkownika.
zz Wyświetla przesunięcie strefy czasowej z zerem wiodącym (na przykład -08)
zzz Wyświetla przesunięcie pełnej strefy czasowej (na przykład -08:00)

Przykład starszego kodu

Poniżej przedstawiono przykłady formatów daty i godziny zdefiniowanych przez użytkownika dla programu December 7, 1958, 8:50 PM, 35 seconds:

Format Wyświetla
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

Uwagi dla deweloperów inteligentnych urządzeń

Minimalna rozdzielczość czasu urządzenia jest określana przez producenta urządzenia. Jeśli rozdzielczość czasu urządzenia jest wystarczająco gruba, f znak formatu zwraca wartość 0 po uruchomieniu na tym urządzeniu.

Dotyczy

Zobacz też