DateAndTime.DateSerial(Int32, Int32, Int32) Método

public:
 static DateTime DateSerial(int Year, int Month, int Day);

public static DateTime DateSerial (int Year, int Month, int Day);

static member DateSerial : int * int * int -> DateTime

Public Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTime

Parâmetros

Retornos

Um valor que representa o ano, mês e dia especificados, com as informações de hora definidas como meia-noite (00:00:00).

Exemplos

Este exemplo usa a DateSerial função para retornar a data do ano, mês e dia especificados.

' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)

' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)

' The following example finds and displays the day of the week that the 
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)

Comentários

Os valores de dois dígitos para o Year argumento são interpretados com base nas configurações do computador definidas pelo usuário. As configurações padrão são que os valores de 0 a 29 são interpretados como os anos de 2000 a 2029 e os valores de 30 a 99 são interpretados como os anos de 1930 a 1999. Para significar todos os outros anos, use um ano de quatro dígitos, por exemplo, 1924.

O exemplo a seguir demonstra valores de argumento negativos, zero e positivos. Aqui, a DateSerial função retorna um Date que representa um dia antes do primeiro dia de março no ano 10 anos antes do ano atual; em outras palavras, o último dia de fevereiro, dez anos atrás.

Dim EndFeb As Date = DateSerial(-10, 3, 0)  

Se ou MonthDay exceder seu intervalo normal, ele será aplicado à próxima unidade maior, conforme apropriado. Por exemplo, se você especificar 32 dias, ele será avaliado como um mês e de um a quatro dias, dependendo do valor de Month. Se Year for maior que 9999 ou se algum argumento estiver fora do intervalo -2.147.483.648 a 2.147.483.647, ocorrerá um ArgumentException erro. Se a data especificada pelos três argumentos for anterior a 00:00:00 em 1º de janeiro do ano 1 ou posterior a 23:59:59 em 31 de dezembro de 9999, ocorrerá um ArgumentOutOfRangeException erro.

O Date tipo de dados inclui componentes de tempo. DateSerial define tudo isso como 0, portanto, o valor retornado representa o início do dia calculado.

Como cada Date valor é suportado por uma DateTime estrutura, seus métodos oferecem opções adicionais na montagem de um Date valor. Por exemplo, você pode usar um dos construtores sobrecarregados DateTime para preencher uma Date variável usando a combinação desejada de componentes. O exemplo a seguir define NewDateTime 6 de maio de 1978 em um décimo de segundo antes das 8:30 da manhã:

Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)  

Aplica-se a

Confira também

• DateValue(String)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Resumo do tipo de dados (Visual Basic)