Strings.FormatDateTime(DateTime, DateFormat) Metoda

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:

Sestavení:: Microsoft.VisualBasic.dll

Vrátí řetězcový výraz představující hodnotu data a času.Returns a string expression representing a date/time value.

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.Required. Date výraz, který má být formátován.Date expression to be formatted.

NamedFormat: DateFormat

Nepovinný parametr.Optional. Číselná hodnota, která označuje použitý formát data a času.Numeric value that indicates the date/time format used. Je-li tento parametr vynechán, DateFormat.GeneralDate je použita hodnota.If omitted, DateFormat.GeneralDate is used.

Návraty

String

Řetězcový výraz představující hodnotu data a času.A string expression representing a date/time value.

Výjimky

ArgumentException

NamedFormat nastavení není platné.NamedFormat setting is not valid.

Příklady

Tento příklad ukazuje použití FormatDateTime funkce.This example demonstrates the use of the FormatDateTime function.

' 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

DateDatový typ vždy obsahuje informace o datu a čase.The Date data type always contains both date and time information. Pro účely konverze typu Visual Basic považuje 1/1/1 (1. ledna of year) za neutrální hodnotu pro datum a 00:00:00 (půlnoc) jako neutrální hodnotu pro čas.For purposes of type conversion, Visual Basic considers 1/1/1 (January 1 of the year 1) to be a neutral value for the date, and 00:00:00 (midnight) to be a neutral value for the time. Pokud formátujete Date hodnotu jako řetězec typu datum/čas, FormatDateTime nezahrnuje neutrální hodnoty ve výsledném řetězci.If you format a Date value as a date/time string, FormatDateTime does not include neutral values in the resulting string. Pokud například převedete #1/1/0001 9:30:00 # na řetězec, výsledek je "9:30:00 dop."; informace o datu jsou potlačeny.For example, if you convert #1/1/0001 9:30:00# to a string, the result is "9:30:00 AM"; the date information is suppressed. Informace o datu jsou však stále přítomny v původní Date hodnotě a lze je obnovit pomocí funkcí, jako je například DatePart .However, the date information is still present in the original Date value and can be recovered with functions such as DatePart.

Poznámka

Pokud předáte Expression argument jako String literál, je FormatDateTime interpretován v závislosti na CurrentCulture nastavení aplikace.If you pass the Expression argument as a String literal, FormatDateTime interprets it according to the CurrentCulture setting of your application. Pokud však předáte jako Date literál, použijte formát #mm/dd/yyyy #, protože FormatDateTime vždy interpretuje Date literál podle jazykové verze anglické (US).However, if you pass it as a Date literal, use the format #mm/dd/yyyy#, because FormatDateTime always interprets a Date literal according to the English (US) culture. To je nezbytné, protože pokud je aplikace vyvíjena a kódována pomocí Date literálů z jedné jazykové verze, ale je poté spuštěna na platformě s jinou jazykovou verzí, Date literály mohou být nesprávně analyzovány.This is necessary because, if an application is developed and coded using Date literals from one culture, but is then executed on a platform with a different culture, the Date literals could be parsed incorrectly.

NamedFormatArgument má následující nastavení.The NamedFormat argument has the following settings.

KonstantaConstant	DescriptionDescription
`DateFormat.GeneralDate`	Zobrazí datum a čas.Display a date and/or time. Zobrazí část data jako krátké datum.Display a date part as a short date. V případě, že je k dispozici nějaká časová část, zobrazte ji jako dlouhou dobu.If there is a time part, display it as a long time. Pokud je k dispozici, zobrazí se obě části.If present, both parts display.
`DateFormat.LongDate`	Zobrazí datum s použitím dlouhého formátu data zadaného v místním nastavení vašeho počítače.Display a date using the long date format specified in your computer's regional settings.
`DateFormat.ShortDate`	Zobrazí datum s použitím krátkého formátu data zadaného v místním nastavení vašeho počítače.Display a date using the short date format specified in your computer's regional settings.
`DateFormat.LongTime`	Zobrazí čas s použitím formátu času zadaného v místním nastavení vašeho počítače.Display a time using the time format specified in your computer's regional settings.
`DateFormat.ShortTime`	Zobrazí čas ve 24hodinovém formátu (hh: mm).Display a time using the 24-hour format (hh:mm).

Platí pro