Strings.FormatDateTime(DateTime, DateFormat) Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

Strings.vb

Vrátí řetězcový výraz představující hodnotu data a času.

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

Parametry

Expression

DateTime

Required. Date výraz, který má být formátován.

NamedFormat

DateFormat

Optional. Číselná hodnota označující použitý formát data a času. Pokud tento parametr vynecháte, DateFormat.GeneralDate použije se.

Návraty

String

Řetězcový výraz představující hodnotu data a času.

Výjimky

ArgumentException

NamedFormat nastavení není platné.

Příklady

Tento příklad ukazuje použití FormatDateTime funkce.

' 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)

Poznámky

Datový Date typ vždy obsahuje informace o datu i čase. Pro účely převodu typu Visual Basic považuje hodnotu 1/1/1 (1. ledna roku 1) za neutrální hodnotu pro datum a 00:00:00 (půlnoc) jako neutrální hodnota pro čas. Pokud hodnotu naformátujete Date jako řetězec data a času, FormatDateTime neobsahuje do výsledného řetězce neutrální hodnoty. Pokud například převedete #1/1/0001 9:30:00# na řetězec, výsledek je "9:30:00"; informace o datu jsou potlačeny. Informace o datu však stále existují v původní Date hodnotě a lze je obnovit pomocí funkcí, jako DatePartje .

Note

Pokud argument předáte Expression jako String literál, FormatDateTime interpretuje ho podle CurrentCulture nastavení aplikace. Pokud ho ale předáte jako Date literál, použijte formát #mm/dd/yy#, protože FormatDateTime vždy interpretuje Date literál podle jazykové verze angličtiny (USA). To je nezbytné, protože pokud je aplikace vyvinuta a kódována pomocí Date literálů z jedné jazykové verze, ale je pak spuštěna na platformě s jinou jazykovou verzí, Date literály by se mohly nesprávně analyzovat.

Argument NamedFormat má následující nastavení.

Konstanta	Description
DateFormat.GeneralDate	Zobrazí datum nebo čas. Zobrazí část data jako krátké datum. Pokud existuje časová část, zobrazte ji jako dlouhou dobu. Pokud je k dispozici, zobrazí se obě části.
DateFormat.LongDate	Zobrazí datum pomocí dlouhého formátu data zadaného v místním nastavení počítače.
DateFormat.ShortDate	Zobrazí datum pomocí krátkého formátu data zadaného v místním nastavení počítače.
DateFormat.LongTime	Zobrazí čas pomocí formátu času určeného v místním nastavení počítače.
DateFormat.ShortTime	Zobrazení času pomocí 24hodinového formátu (hh:mm)

Viz také

• 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)
• Souhrn manipulace s řetězci