Strings.FormatDateTime(DateTime, DateFormat) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve uma expressão de cadeia 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 a formatar.

NamedFormat
DateFormat

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

Devoluções

String

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

Exceções

ArgumentException

NamedFormat O cenário não é válido.

Exemplos

Este exemplo demonstra a utilização 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)

Observações

O Date tipo de dado contém sempre informação de data e hora. Para efeitos de conversão de tipos, o 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 formatar um Date valor como uma cadeia de data/hora, FormatDateTime não inclui valores neutros na cadeia resultante. Por exemplo, se converter #1/1/0001 9:30:00# para uma cadeia, o resultado é "9:30:00 AM"; a data é suprimida. No entanto, as informações de data ainda estão presentes no valor original Date e podem ser recuperadas com funções como DatePart.

Note

Se passares o Expression argumento como String literal, FormatDateTime interpreta-o de acordo com o CurrentCulture contexto da tua candidatura. No entanto, se passares como Date literal, usa o formato #mm/dd/yyyy#, porque FormatDateTime interpreta sempre um Date literal de acordo com a cultura inglesa (EUA). Isto é necessário porque, se uma aplicação for desenvolvida e codificada usando Date literais de uma cultura, mas depois for executada numa plataforma com uma cultura diferente, os Date literais podem ser analisados incorretamente.

O NamedFormat argumento tem as seguintes definições.

Constante Description
DateFormat.GeneralDate Apresentar uma data e/ou hora. Mostra uma parte de encontros como um encontro curto. Se existir uma parte de tempo, apresente-a durante muito tempo. Se presente, ambas as partes são exibidas.
DateFormat.LongDate Apresentar uma data utilizando o formato de data longo especificado nas definições regionais do seu computador.
DateFormat.ShortDate Apresentar uma data utilizando o formato de data abreviada especificado nas definições regionais do seu computador.
DateFormat.LongTime Apresentar uma hora utilizando o formato de hora especificado nas definições regionais do seu computador.
DateFormat.ShortTime Apresentar uma hora com o formato de 24 horas (hh:mm).

Aplica-se a

Ver também