Strings.FormatDateTime(DateTime, DateFormat) Método

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Retorna uma expressão de cadeia de caracteres que representa um valor de data/hora.

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

Parâmetros

Expression
DateTime

Required. Date expressão a ser formatada.

NamedFormat
DateFormat

Optional. Valor numérico que indica o formato de data/hora usado. Se omitido, DateFormat.GeneralDate será usado.

Retornos

String

Uma expressão de cadeia de caracteres que representa um valor de data/hora.

Exceções

ArgumentException

NamedFormat a configuração não é válida.

Exemplos

Este exemplo demonstra o uso da FormatDateTime função.

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

Comentários

O Date tipo de dados sempre contém informações de data e hora. Para fins de conversão de tipo, Visual Basic considera 1/1/1 (1º de janeiro do ano 1) como um valor neutro para a data e 00:00:00 (meia-noite) como um valor neutro para a hora. Se você formatar um Date valor como uma cadeia de caracteres de data/hora, FormatDateTime não inclui valores neutros na cadeia de caracteres resultante. Por exemplo, se você converter #1/1/0001 9:30:00# em uma cadeia de caracteres, o resultado será "9:30:00 AM"; as informações de data são suprimidas. No entanto, as informações de data ainda estão presentes no valor original Date e podem ser recuperadas com funções como DatePart.

Observação

Se você passar o Expression argumento como um String literal, FormatDateTime o interpretará de acordo com a CurrentCulture configuração do aplicativo. No entanto, se você passá-lo como um Date literal, use o formato #mm/dd/yyyy#, porque FormatDateTime sempre interpreta um Date literal de acordo com a cultura inglesa (EUA). Isso é necessário porque, se um aplicativo for desenvolvido e codificado usando Date literais de uma cultura, mas for executado em uma plataforma com uma cultura diferente, os Date literais poderão ser analisados incorretamente.

O NamedFormat argumento tem as seguintes configurações.

Constante Descrição
DateFormat.GeneralDate Exiba uma data e/ou hora. Exiba uma parte de data como uma data curta. Se houver uma parte do tempo, exiba-a por muito tempo. Se estiverem presentes, ambas as partes serão exibidas.
DateFormat.LongDate Exiba uma data usando o formato de data longa especificado nas configurações regionais do computador.
DateFormat.ShortDate Exiba uma data usando o formato de data curta especificado nas configurações regionais do computador.
DateFormat.LongTime Exiba uma hora usando o formato de tempo especificado nas configurações regionais do computador.
DateFormat.ShortTime Exiba uma hora usando o formato de 24 horas (hh:mm).

Aplica-se a

Confira também