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

Restituisce

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 funzione per restituire la DateSerial 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 vengono interpretati in base alle impostazioni del computer definite dall'utente Year . Le impostazioni predefinite sono che i valori compresi tra 0 e 29 vengono interpretati come gli anni 2000-2029 e i valori da 30 a 99 vengono interpretati come gli anni 1930-1999. Per firmare tutti gli altri anni, usare un anno a quattro cifre, ad esempio 1924.

Nell'esempio seguente vengono illustrati valori di argomento negativi, zero e positivi. In questo caso, la DateSerial funzione restituisce un Date oggetto che rappresenta il giorno prima del primo giorno di marzo nell'anno 10 prima dell'anno corrente; in altre parole, l'ultimo giorno di febbraio dieci anni fa.

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

Month Se o Day supera il suo 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 qualsiasi argomento non è compreso nell'intervallo -2.147.483.648 fino a 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, quindi 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 l'assemblaggio di un Date valore. Ad esempio, è possibile usare uno dei costruttori di DateTime overload 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 al mattino:

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

Si applica a

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)