DateAndTime.DateSerial(Int32, Int32, Int32) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

DateAndTime.vb

Restituisce un Date valore che rappresenta l'anno, il mese e il giorno specificati, con le informazioni sull'ora impostate su mezzanotte (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

Parametri

Year

Int32

Obbligatorio. Espressione Integer compresa tra 1 e 9999. Vengono tuttavia accettati anche valori minori di quelli compresi in questo intervallo. Se Year è compreso tra 0 e 99, viene interpretato come compreso tra il 1930 e il 2029, come illustrato nella sezione "Osservazioni". Se Year è minore di 1, viene sottratto dall'anno corrente.

Month

Int32

Obbligatorio. Espressione Integer compresa tra 1 e 12. Vengono tuttavia accettati anche valori non compresi in questo intervallo. Il valore di Month viene diminuito di 1 e applicato a gennaio dell'anno calcolato. In altre parole, (Month - 1) viene aggiunto a gennaio. Se necessario, l'anno viene ricalcolato. Questo effetto è illustrato nei seguenti risultati:

Se Month è uguale a 1, il risultato è gennaio dell'anno calcolato.

Se Month è uguale a 0, il risultato è dicembre dell'anno precedente.

Se Month è uguale a -1, il risultato è novembre dell'anno precedente.

Se Month è uguale a 13, il risultato è gennaio dell'anno successivo.

Day

Int32

Obbligatorio. Espressione Integer compresa tra 1 e 31. Vengono tuttavia accettati anche valori non compresi in questo intervallo. Il valore di Day viene diminuito di 1 e applicato al primo giorno del mese calcolato. In altre parole, (Day - 1) viene aggiunto al primo giorno del mese. Se necessario, il mese e l'anno vengono ricalcolati. Questo effetto è illustrato nei seguenti risultati:

Se Day è uguale a 1, il risultato è il primo giorno dell'anno calcolato.

Se Day è uguale a 0, il risultato è l'ultimo giorno del mese precedente.

Se Day è uguale a 1, il risultato è il penultimo giorno del mese precedente.

Se Day è successivo alla fine del mese corrente, il risultato è il giorno appropriato del mese successivo. Se, ad esempio Month è 4 e Day è 31, il risultato è 1 maggio.

Restituisce

DateTime

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)  

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)