Sdílet prostřednictvím

Strings.FormatDateTime(DateTime, DateFormat) Metoda

  • Reference

Definice

Obor názvů:
Microsoft.VisualBasic
Sestavení:
Microsoft.VisualBasic.Core.dll
Sestavení:
Microsoft.VisualBasic.dll
Zdroj:
Strings.vb
Zdroj:
Strings.vb
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

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

NamedFormat
DateFormat

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

Návraty

String

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

Výjimky

ArgumentException

NamedFormat 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 typů považuje Visual Basic hodnotu 1/1/1 (1. ledna roku 1) za neutrální hodnotu pro dané datum a 00:00:00 (půlnoc) za neutrální hodnotu pro daný čas. Pokud naformátujete Date hodnotu jako řetězec data a času, FormatDateTime nebude ve výsledném řetězci obsahovat neutrální hodnoty. Pokud například převedete #1/1/0001 9:30:00# na řetězec, výsledek bude "9:30:00 AM"; informace o datu jsou potlačeny. Informace o datu jsou však stále obsaženy v původní Date hodnotě a je možné je obnovit pomocí funkcí, jako DatePartje .

Poznámka

Pokud argument předáte Expression jako String literál, FormatDateTime interpretuje ho CurrentCulture podle nastavení vaší aplikace. Pokud ho ale předáte jako Date literál, použijte formát #mm/dd/rrrr#, 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 pak je spuštěna na platformě s jinou jazykovou verzí, Date literály by mohly být nesprávně analyzovány.

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

Konstanta Description
DateFormat.GeneralDate Zobrazí datum a/nebo čas. Zobrazí část data jako krátké datum. Pokud existuje časová část, zobrazte ji jako dlouhý čas. 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 určené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 ve 24hodinovém formátu (hh:mm)

Platí pro

Viz také