Compartilhar via


Tipo de dados Data (Visual Basic)

Mantém a-do IEEE 64-bit (8 -byte) os valores que representam datas desde 1º de janeiro do ano de 0001 a 31 de dezembro do ano 9999 e tempos de 12:00:00 AM (meia-noite) por meio de 11:59:59.9999999 PM. Cada incremento representa 100 nanossegundos tempo decorrido desde o início de 1º de janeiro do ano 1 no calendário gregoriano. O valor máximo representa 100 nanossegundos antes do início de 1º de janeiro do ano 10000.

Comentários

Use o Date tipo de dados para conter os valores de data, hora ou valores de data e hora.

O valor padrão de Date é 0: 00: 00 (meia-noite) em 1º de janeiro de 0001.

Você pode obter a data atual e a hora do deDateAndTimeclasse.

Format Requirements

Você deve colocar um Date literal em sinais numéricos (# #). Você deve especificar o valor de data no formato dd/aaaa, por exemplo #5/31/1993#. Esse requisito é independente de sua localidade e configurações de formato de hora e data do seu computador.

O motivo para essa restrição é que o significado do seu código nunca deve alterar dependendo da localidade na qual seu aplicativo está sendo executado. Suponha que um código de disco rígido-um Date literal de #3/4/1998# e pretende o significado de 4 de março de 1998. Em uma localidade que utilize dd/mm/aaaa, 4 de 3 de 1998 compila conforme pretendido. Mas suponha que você implantar seu aplicativo em muitos países. Em uma localidade que usa mm/dd/aaaa, seu embutido em código literal seria compilar para 3 de abril de 1998. Em uma localidade que usa aaaa/mm/dd, literal seria inválido (abril de 1998, 0003) e causar um errodo compilador.

Soluções alternativas

Para converter um Date literal para o formato de sua localidade, ou para um formato personalizado, forneça o literal para o Format função, especificando tanto um predefinidos ou usuário-definido em formato de data. The following example demonstrates this.

MsgBox("The formatted date is " & Format(#5/31/1993#, "dddd, d MMM yyyy"))

Como alternativa, você pode usar um dos construtores sobrecarregados da DateTime estrutura para montar uma data e o valor temporal. O exemplo a seguir cria um valor para representar o dia 31 de maio de 1993 em 12: 14 à tarde.

Dim dateInMay As New System.DateTime(1993, 5, 31, 12, 14, 0) 

Formatarde hora

Você pode especificar o valor temporal em 12 horas de-ou em formato de hora 24-, por exemplo #1:15:30 PM# ou #13:15:30#. No entanto, se você não especificar os minutos ou segundos, você deve especificar AM ou PM.

Data e Hora padrões

Se você não incluir uma data em uma literal de data/hora, o Visual Basic define a parte da data do valor para 1º de janeiro de 0001. Se você não incluir uma hora em um literal de data/hora, o Visual Basic define a parte do tempo do valor para o início do dia, ou seja, meia-noite (0: 00).

Type Conversions

Se você converter um Date valor para o String Visual Basic processa a data de acordo com o formato de data abreviada especificado pela execução de-de hora localidade, de tipo, e ele processa a hora de acordo com o formato de hora (um dos 12-horas ou 24 horas de-), especificado pela execução de-tempo localidade.

Programming Tips

  • Considerações de interoperabilidade. Se você está em uma interface com componentes não são escritos para o.NET Framework, por exemplo, automação ou COM objetos, tenha em mente que os tipos em outros ambientes de data/hora não são compatíveis com o Visual Basic Date tipo. Caso você esteja passando um argumento de data/hora para tal componente, declará-lo como Double em vez de Date em seu novo de Visual Basic de código e use os métodos de conversão DateTime.FromOADate e DateTime.ToOADate.

  • Tipo Caracteres. Date tem nenhum caractere de tipo literal ou identificador tipo de caractere. No entanto, o compilador trata literais envolto em sinais numéricos (# #) como Date.

  • Framework Type. O tipo correspondente na.NET Framework é o System.DateTime estrutura.

Exemplo

Uma variável ou constante do Date tipo de dados contém a data e hora. The following example illustrates this.

Dim someDateAndTime As Date = #8/13/2002 12:14 PM#

Consulte também

Referência

Resumo de tipo de dados (Visual Basic)

System.DateTime

Funções de conversão de tipo (Visual Basic)

Resumo de conversão (Visual Basic)

Conceitos

Uso eficiente de tipos de dados (Visual Basic)