Strings.FormatDateTime(DateTime, DateFormat) Metódus

Definíció

Névtér:

Microsoft.VisualBasic

Szerelvény:

Microsoft.VisualBasic.Core.dll

Forrás:

Strings.vb

Egy dátum/idő értéket képviselő sztringkifejezést ad vissza.

public static string FormatDateTime(DateTime Expression, Microsoft.VisualBasic.DateFormat NamedFormat = Microsoft.VisualBasic.DateFormat.GeneralDate);

static member FormatDateTime : DateTime * Microsoft.VisualBasic.DateFormat -> string

Public Function FormatDateTime (Expression As DateTime, Optional NamedFormat As DateFormat = Microsoft.VisualBasic.DateFormat.GeneralDate) As String

Paraméterek

Expression

DateTime

Kötelező. Date formázandó kifejezés.

NamedFormat

DateFormat

Optional. A használt dátum-/időformátumot jelző numerikus érték. Ha nincs megadva, DateFormat.GeneralDate akkor a rendszer használja.

Válaszok

String

Dátum/idő értéket képviselő sztringkifejezés.

Kivételek

ArgumentException

NamedFormat beállítás érvénytelen.

Példák

Ez a példa a függvény használatát FormatDateTime mutatja be.

' English (US) format.
Dim testDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".
' The time information is neutral (00:00:00) and therefore suppressed.
Dim testString As String = FormatDateTime(testDate, DateFormat.LongDate)

Megjegyzések

Az Date adattípus mindig dátum- és időadatokat tartalmaz. Típusátalakítás céljából a Visual Basic az 1/1/1 -et (az év január 1-ét) a dátum semleges értékének tekinti, a 00:00:00 (éjfél) pedig az időpont semleges értékét. Ha dátum/idő sztringként formáz egy Date értéket, FormatDateTime akkor nem tartalmaz semleges értékeket az eredményül kapott sztringben. Ha például az #1/1/0001 9:30:00# értéket sztringgé konvertálja, az eredmény "9:30:00"; a dátumadatok el lesznek tiltva. A dátumadatok azonban továbbra is megtalálhatók az eredeti Date értékben, és olyan függvényekkel állíthatók helyre, mint a DatePart.

Note

Ha az Expression argumentumot konstansként String adja át, FormatDateTime az alkalmazás beállításainak megfelelően CurrentCulture értelmezi azt. Ha azonban konstansként Date adja át, használja a #mm/dd/yyyy# formátumot, mert FormatDateTime mindig az angol (US) kultúra szerint értelmezi Date a literált. Erre azért van szükség, mert ha egy alkalmazást egy adott kultúrából származó literálok használatával Date fejlesztenek ki és kódoltak, de egy másik kultúrával rendelkező platformon hajtják végre, akkor a Date literálok helytelenül elemezhetők.

Az NamedFormat argumentum a következő beállításokkal rendelkezik.

Állandó	Leírás
DateFormat.GeneralDate	Dátum és/vagy idő megjelenítése. Dátumrész megjelenítése rövid dátumként. Ha van időrész, hosszú ideig jelenítse meg. Ha jelen van, mindkét rész megjelenik.
DateFormat.LongDate	Dátum megjelenítése a számítógép területi beállításaiban megadott hosszú dátumformátummal.
DateFormat.ShortDate	Dátum megjelenítése a számítógép területi beállításaiban megadott rövid dátumformátummal.
DateFormat.LongTime	Idő megjelenítése a számítógép területi beállításaiban megadott időformátummal.
DateFormat.ShortTime	Idő megjelenítése 24 órás formátumban (óó:mm).

Lásd még

• Format(Object, String)
• FormatCurrency(Object, Int32, TriState, TriState, TriState)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• ArgumentException
• DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
• Sztringmanipult-kezelés összefoglalása