Compartilhar via


Tipo de dados Data (Visual Basic)

Contém os valores IEEE de 64 bits (8 bytes) que representam datas que variam do 1º de janeiro do ano 0001 até o 31 de dezembro do ano 9999, e hora de 12:00: 00 AM (meia-noite) com o 11:59: 59,9999999. Cada incremento representa 100 nanossegundos de tempo decorrido desde princípio de 1 de janeiro do ano 1 no calendário gregoriano. O valor máximo representa 100 nanossegundos antes de início de 1 de janeiro do ano 10000.

Comentários

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

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

Você pode obter a data e hora da classe de DateAndTime .

Requisitos de Formato

Você deve incluir um literal Date entre sinais de número (# #). Você deve especificar o valor de data no formato Dd/mm/yyyy, por exemplo #5/31/1993#. Esse requisito é independente das configurações de localidade e de formato de data e hora do computador.

A razão para essa limitação é que o significado de seu código nunca deve alterar dependendo da localidade na qual o aplicativo está sendo executado. Suponha o irá embutir um literal de Date de #3/4/1998# e pretenda-o significar o 4 de março de 1998. Em uma localidade que usa dd/mm/aaaa, 3/4/1998 criados como você pretende. Mas suponha que você implanta seu aplicativo em muitos países. Em uma localidade que usa dd/mm/yyyy, o literal embutido compilaria a o 3 de abril de 1998. Em uma localidade que usa aaaa/mm/dd, o literal seria inválido (em abril de 1998, 0003) e causaria um erro do compilador.

Soluções alternativas

Para converter um literal de Date o formato de sua localidade, ou em um formato personalizado, forneça o literal à função de Format , especificando um formato de data predefinido ou definido pelo usuário. 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 de estrutura de DateTime para montar um valor de data e hora. O exemplo a seguir cria um valor para representar o 31 de maio de 1993 no 12:14 em tarde.

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

Formato de hora

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

Opções de data e hora

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

Conversão de Tipos

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

Dicas de Programação

  • Considerações de Interoperabilidade. Se você estiver interfaceando com componentes não escritos para o.NET Framework, por exemplo automação ou objetos COM, tenha em mente que a data/hora em outros ambientes não é compatível com o tipo do Visual Basic Date . Se você estiver passando um argumento de data/hora para tal componente, declare-o como em vez de DoubleDate no novo código Visual Basic, e use os métodos de conversão DateTime.FromOADate e DateTime.ToOADate.

  • **Caracteres de tipo.**Date não tem caracteres de tipo literais ou caracteres de tipo identificadores. No entanto, o compilador trata literais entre sinais de número (# #) como Date.

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

Exemplo

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

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

Consulte também

Referência

Resumo do tipo de dados (Visual Basic)

DateTime

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

Resumo da conversão (Visual Basic)

Conceitos

Cadeias de caracteres de formato de data e hora padrão

Cadeias de caracteres de formato de data e hora personalizado

Uso eficiente de tipos de dados (Visual Basic)