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