DateAndTime.DateSerial(Int32, Int32, Int32) Metodo

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

Parametri

Valori restituiti

Valore che rappresenta l'anno, il mese e il giorno specificati, con le informazioni sull'ora impostate su mezzanotte (00:00:00).

Esempio

In questo esempio viene utilizzata la DateSerial funzione per restituire la data per l'anno, il mese e il giorno specificati.

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

Commenti

I valori a due cifre per l'argomento Year vengono interpretati in base alle impostazioni del computer definite dall'utente. Le impostazioni predefinite sono che i valori compresi tra 0 e 29 vengono interpretati come gli anni 2000-2029 e i valori compresi tra 30 e 99 vengono interpretati come gli anni 1930-1999. Per indicare tutti gli altri anni, usare un anno a quattro cifre, ad esempio 1924.

Nell'esempio seguente vengono illustrati i valori negativi, zero e positivi degli argomenti. In questo caso, la DateSerial funzione restituisce un oggetto Date che rappresenta il giorno precedente al primo giorno di marzo nell'anno 10 anni prima dell'anno corrente, ovvero l'ultimo giorno di febbraio dieci anni fa.

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

Se o MonthDay supera l'intervallo normale, viene applicato all'unità più grande successiva in base alle esigenze. Ad esempio, se si specificano 32 giorni, viene valutato come un mese e da uno a quattro giorni, a seconda del valore di Month. Se Year è maggiore di 9999 o se un argomento non è compreso nell'intervallo -2.147.483.648 da 2.147.483.647, si verifica un ArgumentException errore. Se la data specificata dai tre argomenti è precedente alle 00:00:00 del 1° gennaio dell'anno 1 o successiva alle 23:59:59 del 31 dicembre 9999, si verifica un ArgumentOutOfRangeException errore.

Il Date tipo di dati include componenti temporali. DateSerial imposta tutti questi valori su 0, pertanto il valore restituito rappresenta l'inizio del giorno calcolato.

Poiché ogni Date valore è supportato da una DateTime struttura, i relativi metodi offrono opzioni aggiuntive per assemblare un Date valore. Ad esempio, è possibile usare uno dei costruttori di overload DateTime per popolare una Date variabile usando la combinazione desiderata di componenti. L'esempio seguente imposta NewDateTime su 6 maggio 1978 un decimo di secondo prima delle 8:30 del mattino:

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

Vedi anche

• DateValue(String)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Riepilogo dei tipi di dati (Visual Basic)