Strings.Format(Object, String) Metódus

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

Paraméterek

Válaszok

Egy formázási String kifejezés utasításainak megfelelően formázott sztring.

Példák

Ez a példa a függvény különböző használatával formázza az értékeket mind a Format formátumok, mind String a felhasználó által definiált formátumok használatával. A dátumelválasztó (/), az időelválasztó (:) és az AM/PM jelzők (t és tt) esetében a rendszer által megjelenített tényleges formázott kimenet a kód területi beállításaitól függ. A fejlesztőkörnyezetben a kód területi beállításának megfelelő rövid időformátum és rövid dátumformátum jelenik meg.

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

Megjegyzések

A String.Format módszer hasonló funkciókat is biztosít.

Ha nem lokális numerikus sztringet formáz, felhasználó által definiált numerikus formátumot kell használnia, hogy biztosan a kívánt megjelenést kapja.

Ha megadásával próbál formázni egy számot Style, a függvény a FormatStr függvényhez hasonló funkciókat biztosít, bár nemzetközileg is tisztában van vele. A függvényt használó Format sztringként formázott pozitív számok azonban nem tartalmaznak az érték jeléhez fenntartott kezdő szóközt; a Str függvény használatával konvertált számok megtartják a kezdő szóközt.

Különböző numerikus értékek különböző formátumai

A számok felhasználó által definiált formátumkifejezései egytől háromig lehetnek pontosvesszővel elválasztva. Ha a StyleFormat függvény argumentuma az előre definiált numerikus formátumok egyikét tartalmazza, csak egy szakasz engedélyezett.

A következő példa két szakaszból áll: az első a pozitív értékek és nullák formátumát határozza meg; a második szakasz a negatív értékek formátumát határozza meg. Mivel a StyleFormat függvény argumentuma sztringet használ, idézőjelek közé kerül.

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

Ha olyan pontosvesszőket tartalmaz, amelyek között nincs köztük semmi, a hiányzó szakaszt a rendszer a pozitív érték formátumával nyomtatja ki. Az alábbi formátum például pozitív és negatív értékeket jelenít meg az első szakaszban szereplő formátummal, és megjeleníti Zero , ha az érték nulla.

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

Előre definiált numerikus formátumok

Az alábbi táblázat az előre definiált numerikus formátumneveket azonosítja. Ezek név alapján használhatók a StyleFormat függvény argumentumaként:

Intelligens eszközök fejlesztői megjegyzései

A Yes/No, True/Falseés On/Off a formátumok nem támogatottak.

User-Defined numerikus formátumok

Az alábbi táblázat a felhasználó által definiált számformátumok létrehozásához használható karaktereket azonosítja. Ezek használhatók a függvény argumentumának StyleFormat létrehozásához:

Régi kód példa

Az alábbi táblázat néhány számformátum-mintakifejezést tartalmaz. (Ezek a példák mind feltételezik, hogy a rendszer területi beállítása angol–amerikai) Az első oszlop a függvény argumentumához tartozó Style formázási Format sztringeket tartalmazza, a többi oszlop pedig az eredményül kapott kimenetet, ha a formázott adatok az oszlopfejlécekben megadott értéket tartalmazzák.

Előre definiált dátum-/időformátumok

Az alábbi táblázat az előre definiált dátum- és időformátum-neveket azonosítja. Ezek név alapján használhatók a függvény stílusargumentumaként Format :

Az alkalmazás aktuális kulturális adatairól a Visual Basic Kultúra hatással van sztringjeinek megjelenítése című témakörben talál további információt.

User-Defined dátum-/időformátumok

Az alábbi táblázat a felhasználó által definiált dátum-/időformátumok létrehozásához használható karaktereket mutatja be. A Visual Basic korábbi verzióitól eltérően ezek a formátumkarakterek megkülönböztetik a kis- és nagybetűket.

Régi kód példa

Az alábbiakban példákat láthat a felhasználó által megadott dátum- és időformátumokra a következőhöz December 7, 1958, 8:50 PM, 35 seconds:

Intelligens eszközök fejlesztői megjegyzései

Az eszköz minimális időfeloldását az eszköz gyártója határozza meg. Ha az eszköz időfeloldása elég durva, a f formátum karakter 0 értéket ad vissza az eszközön való futtatáskor.

Lásd még

• Format(String, Object)
• Str(Object)
• Sztringmanipult-kezelés összefoglalása