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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

DateAndTime.vb

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

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

Year

Int32

Obrigatórios. Expressão de inteiro de 1 a 9999. No entanto, valores abaixo desse intervalo também são aceitos. Se Year for de 0 a 99, ele será interpretado como sendo entre 1930 e 2029, conforme explicado na seção "Comentários". Se Year for menor que 1, ele será subtraído do ano atual.

Month

Int32

Obrigatórios. Expressão de inteiro de 1 a 12. No entanto, valores fora desse intervalo também são aceitos. O valor de Month é deslocado em 1 e aplicado a janeiro do ano calculado. Em outras palavras, (Month - 1) é adicionado a janeiro. O ano é recalculado se necessário. Os seguintes resultados ilustram esse efeito:

Se Month for 1, o resultado será janeiro do ano calculado.

Se Month for 0, o resultado será dezembro do ano anterior.

Se Month for -1, o resultado será novembro do ano anterior.

Se Month for 13, o resultado será janeiro do ano seguinte.

Day

Int32

Obrigatórios. Expressão de inteiro de 1 a 31. No entanto, valores fora desse intervalo também são aceitos. O valor de Day é deslocado em 1 e aplicado ao primeiro dia do mês calculado. Em outras palavras, (Day - 1) é adicionado ao primeiro dia do mês. O mês e ano são recalculados, se necessário. Os seguintes resultados ilustram esse efeito:

Se Day for 1, o resultado será o primeiro dia do mês calculado.

Se Day for 0, o resultado será o último dia do mês anterior.

Se Day for -1, o resultado será o penúltimo dia do mês anterior.

Se Day for posterior ao fim do mês atual, o resultado será o dia apropriado do mês seguinte. Por exemplo, se Month for 4 e Day for 31, o resultado será 1º de maio.

Retornos

DateTime

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)  

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)