Compartilhar via


Tipo de dados Data (Visual Basic)

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

Comentários

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

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

Requisitos de Formato

Você deve colocar um Date literal dentro (sinais de número# #). Você deve especificar o valor de data no formato D/m/aaaa, por exemplo, #5/31/1993#. Esse requisito é independente de sua localidade e a data do seu computador e as configurações de formato de time.

A razão para essa restrição é que o significado do seu código nunca deve alterar dependendo do local em que seu aplicativo estiver sendo executado.Suponha que você codificar um Date literal de #3/4/1998# e pretende para significar 4 de março de 1998. Uma localidade que usa mm/dd/aaaa, 3/4/1998 é compilado sistema autônomo você deseja.Mas suponha que você implantar seu aplicativo em diversos países.Em local que utilize dd/mm/aaaa, seria compilar seu literal codificados para 3 de abril de 1998.Em uma localidade que usa aaaa/mm/dd, o literal seria inválido (abril de 1998, 0003) e causar um erro do 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 Função Format, especificando um Formatos de Data/Hora predefinidos (função Format) ou Formatos de data/time definidos pelo usuário (função Format). O exemplo a seguir demonstra isso.

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

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

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

Formato de hora

Você pode especificar o valor temporal no formato de 12 horas ou 24 horas, 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 time padrões

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

Conversão de Tipos

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

Dicas de Programação

  • Considerações de Interoperabilidade. Se você está em uma interface com componentes não escritos para o .NET estrutura, por exemplo automação ou COM objetos, lembre-se de que os tipos em outros ambientes de data/time não são compatível com o Visual Basic Date Digite. Caso você esteja passando um argumento de data/time para tal um componente, declare-o sistema autônomo Double em vez de Date em seu novo do Visual Basic code e use sistema autônomo métodos de conversão DateTime.FromOADate e DateTime.ToOADate.

  • **Type Characters.**Date has no literal type character or identifier type character.No entanto, o compilador trata literais entre sinais numéricos (# #) sistema autônomo Date.

  • Tipos de Framework. O tipo correspondente no .NET Framework é a estrutura System.DateTime.

Exemplo

Uma variável ou constante do Date tipo de dados contém a data e a time. O exemplo a seguir ilustra isto:

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

Consulte também

Conceitos

Uso eficiente de tipos de dados

Alterações nos tipos de dados para usuários do Visual Basic 6.0

Referência

Resumo de tipo de dados (Visual Basic)

System.DateTime

Funções de conversão de tipo 

Resumo de conversão