DateAndTime.DateDiff Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Restituisce un valore che specifica il numero di intervalli di tempo tra due valori Date.

Overload

DateDiff(DateInterval, DateTime, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Sottrae `Date1` da `Date2` per assegnare un valore lungo che specifica il numero di intervalli di tempo tra i due valori `Date`.
DateDiff(String, Object, Object, FirstDayOfWeek, FirstWeekOfYear)	Sottrae `Date1` da `Date2` per assegnare un valore lungo che specifica il numero di intervalli di tempo tra i due valori `Date`.

DateDiff(DateInterval, DateTime, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Origine:: DateAndTime.vb

Origine:: DateAndTime.vb

Origine:: DateAndTime.vb

Sottrae Date1 da Date2 per assegnare un valore lungo che specifica il numero di intervalli di tempo tra i due valori Date.

public static long DateDiff (Microsoft.VisualBasic.DateInterval Interval, DateTime Date1, DateTime Date2, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

static member DateDiff : Microsoft.VisualBasic.DateInterval * DateTime * DateTime * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> int64

Public Function DateDiff (Interval As DateInterval, Date1 As DateTime, Date2 As DateTime, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Long

Parametri

Interval: DateInterval

Obbligatorio. Valore di enumerazione DateInterval o espressione stringa che rappresenta l'intervallo di tempo da usare come unità di differenza tra Date1 e Date2.

Date1: DateTime

Obbligatorio. Primo valore di data/ora da usare nel calcolo.

Date2: DateTime

Obbligatorio. Secondo valore di data/ora da usare nel calcolo.

DayOfWeek: FirstDayOfWeek

Opzionale. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana. Se non specificato, viene utilizzato Sunday.

WeekOfYear: FirstWeekOfYear

Opzionale. Valore scelto dall'enumerazione FirstWeekOfYear che specifica la prima settimana dell'anno. Se non specificato, viene utilizzato Jan1.

Restituisce

Int64

Valore long che specifica il numero di intervalli di tempo tra due valori Date.

Eccezioni

ArgumentException

Date1, Date2o DayofWeek non è compreso nell'intervallo.

InvalidCastException

Date1 o Date2 è di un tipo non valido.

Esempio

In questo esempio viene utilizzata la funzione DateDiff per visualizzare il numero di giorni compresi tra una data specificata e oggi.

Dim date2Entered As String = InputBox("Enter a date")

Try
    Dim date2 As Date = Date.Parse(date2Entered)
    Dim date1 As Date = Now

    ' Determine the number of days between the two dates.
    Dim days As Long = DateDiff(DateInterval.Day, date1, date2)

    ' This statement has a string interval argument, and
    ' is equivalent to the above statement.
    'Dim days As Long = DateDiff("d", date1, date2)

    MessageBox.Show("Days from today: " & days.ToString)
Catch ex As Exception
    MessageBox.Show("Invalid Date: " & ex.Message)
End Try

Commenti

È possibile usare la funzione DateDiff per determinare il numero di intervalli di tempo specificati tra due valori di data/ora. Ad esempio, è possibile usare DateDiff per calcolare il numero di giorni tra due date o il numero di settimane tra oggi e la fine dell'anno.

Comportamento

Trattamento dei parametri. DateDiff sottrae il valore di Date1 dal valore di Date2 per produrre la differenza. Nessun valore viene modificato nel programma chiamante.
Valori restituiti. Poiché Date1 e Date2 sono del tipo di dati Date, contengono valori di data e ora accurati a 100 nanosecondi nel timer di sistema. Tuttavia, DateDiff restituisce sempre il numero di intervalli di tempo come valore Long.

Se Date1 rappresenta una data e un'ora successive rispetto a Date2, DateDiff restituisce un numero negativo.
Intervalli di giorno. Se Interval è impostato su DateInterval.DayOfYear, viene considerato uguale a DateInterval.Day, perché DayOfYear non è un'unità significativa per un intervallo di tempo.
Intervalli di settimana. Se Interval è impostato su DateInterval.WeekOfYear, il valore restituito rappresenta il numero di settimane tra il primo giorno della settimana contenente Date1 e il primo giorno della settimana contenente Date2. Nell'esempio seguente viene illustrato come questo produce risultati diversi da DateInterval.Weekday.
```
' The following statements set datTim1 to a Thursday
' and datTim2 to the following Tuesday.
Dim datTim1 As Date = #1/4/2001#
Dim datTim2 As Date = #1/9/2001#
' Assume Sunday is specified as first day of the week.
Dim wD As Long = DateDiff(DateInterval.Weekday, datTim1, datTim2)
Dim wY As Long = DateDiff(DateInterval.WeekOfYear, datTim1, datTim2)
```
Nell'esempio precedente, DateDiff restituisce 0 a wD perché la differenza tra le due date è inferiore a sette giorni, ma restituisce 1 a wY perché esiste una differenza di sette giorni tra i primi giorni delle rispettive settimane di calendario.
Intervalli maggiori. Se Interval è impostato su DateInterval.Year, il valore restituito viene calcolato esclusivamente dalle parti dell'anno di Date1 e Date2. Analogamente, il valore restituito per DateInterval.Month viene calcolato esclusivamente dalle parti dell'anno e del mese degli argomenti e per DateInterval.Quarter dai trimestri contenenti le due date.

Ad esempio, quando si confronta il 31 dicembre e il 1° gennaio dell'anno successivo, DateDiff restituisce 1 per DateInterval.Year, DateInterval.Quartero DateInterval.Month, anche se al massimo è trascorso un solo giorno.

Per le impostazioni cultura come il giapponese con più ere, il metodo DateDiff non restituisce una differenza negli anni se la differenza si estende su due o più ere. È invece possibile calcolare la differenza nei valori restituiti dalla proprietà Year, come illustrato nell'esempio seguente: date2.Year - date1.Year.
Altri intervalli. Poiché ogni valore Date è supportato da una struttura DateTime, i relativi metodi offrono opzioni aggiuntive per trovare gli intervalli di tempo. Ad esempio, è possibile utilizzare il metodo Subtract in uno dei relativi formati di overload: DateTime.Subtract sottrae una TimeSpan da una variabile Date per restituire un altro valore Date e DateTime.Subtract sottrae un valore Date per restituire un TimeSpan. È possibile tempore per un processo per scoprire il numero di millisecondi necessari, come illustrato nell'esempio seguente.
```
Dim startTime As Date = Now
' Run the process that is to be timed.
Dim runLength As Global.System.TimeSpan = Now.Subtract(startTime)
Dim millisecs As Double = runLength.TotalMilliseconds
```

L'argomento Interval può avere una delle impostazioni seguenti.

Valore di enumerazione	Valore stringa	Unità di differenza di tempo
`DateInterval.Day`	"d"	Giorno
`DateInterval.DayOfYear`	"y"	Giorno
`DateInterval.Hour`	"h"	Ora
`DateInterval.Minute`	"n"	Minuto
`DateInterval.Month`	"m"	Mese
`DateInterval.Quarter`	"q"	Quarto
`DateInterval.Second`	"s"	Secondo
`DateInterval.Weekday`	"w"	Settimana
`DateInterval.WeekOfYear`	"ww"	Settimana del calendario
`DateInterval.Year`	"yyyy"	Anno

L'argomento DayOfWeek può avere una delle impostazioni seguenti.

Valore di enumerazione	Valore	Descrizione
`FirstDayOfWeek.System`	0	Primo giorno della settimana specificato nelle impostazioni di sistema
`FirstDayOfWeek.Sunday`	1	Domenica (impostazione predefinita)
`FirstDayOfWeek.Monday`	2	Monday (conforme allo standard ISO 8601, sezione 3.17)
`FirstDayOfWeek.Tuesday`	3	Martedì
`FirstDayOfWeek.Wednesday`	4	Mercoledì
`FirstDayOfWeek.Thursday`	5	Giovedì
`FirstDayOfWeek.Friday`	6	Venerdì
`FirstDayOfWeek.Saturday`	7	Sabato

L'argomento WeekOfYear può avere una delle impostazioni seguenti.

Valore di enumerazione	Valore	Descrizione
`FirstWeekOfYear.System`	0	Prima settimana dell'anno specificata nelle impostazioni di sistema
`FirstWeekOfYear.Jan1`	1	Settimana in cui si verifica il 1° gennaio (impostazione predefinita)
`FirstWeekOfYear.FirstFourDays`	2	Settimana con almeno quattro giorni nel nuovo anno (conforme allo standard ISO 8601, sezione 3.17)
`FirstWeekOfYear.FirstFullWeek`	3	Prima settimana intera nel nuovo anno

Vedi anche

Si applica a

DateDiff(String, Object, Object, FirstDayOfWeek, FirstWeekOfYear)

Origine:: DateAndTime.vb

Origine:: DateAndTime.vb

Origine:: DateAndTime.vb

Sottrae Date1 da Date2 per assegnare un valore lungo che specifica il numero di intervalli di tempo tra i due valori Date.

public static long DateDiff (string Interval, object? Date1, object? Date2, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

public static long DateDiff (string Interval, object Date1, object Date2, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

static member DateDiff : string * obj * obj * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> int64

Public Function DateDiff (Interval As String, Date1 As Object, Date2 As Object, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Long

Parametri

Interval: String

Obbligatorio. Valore di enumerazione DateInterval o espressione stringa che rappresenta l'intervallo di tempo da usare come unità di differenza tra Date1 e Date2.

Date1: Object

Obbligatorio. Primo valore di data/ora da usare nel calcolo.

Date2: Object

Obbligatorio. Secondo valore di data/ora da usare nel calcolo.

DayOfWeek: FirstDayOfWeek

Opzionale. Valore scelto dall'enumerazione FirstDayOfWeek che specifica il primo giorno della settimana. Se non specificato, viene utilizzato Sunday.

WeekOfYear: FirstWeekOfYear

Opzionale. Valore scelto dall'enumerazione FirstWeekOfYear che specifica la prima settimana dell'anno. Se non specificato, viene utilizzato Jan1.

Restituisce

Int64

Valore long che specifica il numero di intervalli di tempo tra due valori Date.

Eccezioni

ArgumentException

Date1, Date2o DayofWeek non è compreso nell'intervallo.

InvalidCastException

Date1 o Date2 è di un tipo non valido.

Esempio

In questo esempio viene utilizzata la funzione DateDiff per visualizzare il numero di giorni compresi tra una data specificata e oggi.

Dim date2Entered As String = InputBox("Enter a date")

Try
    Dim date2 As Date = Date.Parse(date2Entered)
    Dim date1 As Date = Now

    ' Determine the number of days between the two dates.
    Dim days As Long = DateDiff(DateInterval.Day, date1, date2)

    ' This statement has a string interval argument, and
    ' is equivalent to the above statement.
    'Dim days As Long = DateDiff("d", date1, date2)

    MessageBox.Show("Days from today: " & days.ToString)
Catch ex As Exception
    MessageBox.Show("Invalid Date: " & ex.Message)
End Try

Commenti

Comportamento

Trattamento dei parametri. DateDiff sottrae il valore di Date1 dal valore di Date2 per produrre la differenza. Nessun valore viene modificato nel programma chiamante.
Valori restituiti. Poiché Date1 e Date2 sono del tipo di dati Date, contengono valori di data e ora accurati a 100 nanosecondi nel timer di sistema. Tuttavia, DateDiff restituisce sempre il numero di intervalli di tempo come valore Long.

Se Date1 rappresenta una data e un'ora successive rispetto a Date2, DateDiff restituisce un numero negativo.
Intervalli di giorno. Se Interval è impostato su DateInterval.DayOfYear, viene considerato uguale a DateInterval.Day, perché DayOfYear non è un'unità significativa per un intervallo di tempo.
Intervalli di settimana. Se Interval è impostato su DateInterval.WeekOfYear, il valore restituito rappresenta il numero di settimane tra il primo giorno della settimana contenente Date1 e il primo giorno della settimana contenente Date2. Nell'esempio seguente viene illustrato come questo produce risultati diversi da DateInterval.Weekday.
```
' The following statements set datTim1 to a Thursday
' and datTim2 to the following Tuesday.
Dim datTim1 As Date = #1/4/2001#
Dim datTim2 As Date = #1/9/2001#
' Assume Sunday is specified as first day of the week.
Dim wD As Long = DateDiff(DateInterval.Weekday, datTim1, datTim2)
Dim wY As Long = DateDiff(DateInterval.WeekOfYear, datTim1, datTim2)
```
Nell'esempio precedente, DateDiff restituisce 0 a wD perché la differenza tra le due date è inferiore a sette giorni, ma restituisce 1 a wY perché esiste una differenza di sette giorni tra i primi giorni delle rispettive settimane di calendario.
Intervalli maggiori. Se Interval è impostato su DateInterval.Year, il valore restituito viene calcolato esclusivamente dalle parti dell'anno di Date1 e Date2. Analogamente, il valore restituito per DateInterval.Month viene calcolato esclusivamente dalle parti dell'anno e del mese degli argomenti e per DateInterval.Quarter dai trimestri contenenti le due date.

Ad esempio, quando si confronta il 31 dicembre e il 1° gennaio dell'anno successivo, DateDiff restituisce 1 per DateInterval.Year, DateInterval.Quartero DateInterval.Month, anche se al massimo è trascorso un solo giorno.

Per le impostazioni cultura come il giapponese con più ere, il metodo DateDiff non restituisce una differenza negli anni se la differenza si estende su due o più ere. È invece possibile calcolare la differenza nei valori restituiti dalla proprietà Year, come illustrato nell'esempio seguente: date2.Year - date1.Year.
Altri intervalli. Poiché ogni valore Date è supportato da una struttura DateTime, i relativi metodi offrono opzioni aggiuntive per trovare gli intervalli di tempo. Ad esempio, è possibile utilizzare il metodo Subtract in uno dei relativi formati di overload: DateTime.Subtract sottrae una TimeSpan da una variabile Date per restituire un altro valore Date e DateTime.Subtract sottrae un valore Date per restituire un TimeSpan. È possibile tempore per un processo per scoprire il numero di millisecondi necessari, come illustrato nell'esempio seguente.
```
Dim startTime As Date = Now
' Run the process that is to be timed.
Dim runLength As Global.System.TimeSpan = Now.Subtract(startTime)
Dim millisecs As Double = runLength.TotalMilliseconds
```

L'argomento Interval può avere una delle impostazioni seguenti.

Valore di enumerazione	Valore stringa	Unità di differenza di tempo
`DateInterval.Day`	"d"	Giorno
`DateInterval.DayOfYear`	"y"	Giorno
`DateInterval.Hour`	"h"	Ora
`DateInterval.Minute`	"n"	Minuto
`DateInterval.Month`	"m"	Mese
`DateInterval.Quarter`	"q"	Quarto
`DateInterval.Second`	"s"	Secondo
`DateInterval.Weekday`	"w"	Settimana
`DateInterval.WeekOfYear`	"ww"	Settimana del calendario
`DateInterval.Year`	"yyyy"	Anno

L'argomento DayOfWeek può avere una delle impostazioni seguenti.

Valore di enumerazione	Valore	Descrizione
`FirstDayOfWeek.System`	0	Primo giorno della settimana specificato nelle impostazioni di sistema
`FirstDayOfWeek.Sunday`	1	Domenica (impostazione predefinita)
`FirstDayOfWeek.Monday`	2	Monday (conforme allo standard ISO 8601, sezione 3.17)
`FirstDayOfWeek.Tuesday`	3	Martedì
`FirstDayOfWeek.Wednesday`	4	Mercoledì
`FirstDayOfWeek.Thursday`	5	Giovedì
`FirstDayOfWeek.Friday`	6	Venerdì
`FirstDayOfWeek.Saturday`	7	Sabato

L'argomento WeekOfYear può avere una delle impostazioni seguenti.

Valore di enumerazione	Valore	Descrizione
`FirstWeekOfYear.System`	0	Prima settimana dell'anno specificata nelle impostazioni di sistema
`FirstWeekOfYear.Jan1`	1	Settimana in cui si verifica il 1° gennaio (impostazione predefinita)
`FirstWeekOfYear.FirstFourDays`	2	Settimana con almeno quattro giorni nel nuovo anno (conforme allo standard ISO 8601, sezione 3.17)
`FirstWeekOfYear.FirstFullWeek`	3	Prima settimana intera nel nuovo anno

Vedi anche

Si applica a

Condividi tramite

DateAndTime.DateDiff Metodo

Definizione

Overload

DateDiff(DateInterval, DateTime, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Comportamento

Vedi anche

Si applica a

DateDiff(String, Object, Object, FirstDayOfWeek, FirstWeekOfYear)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Comportamento

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive