DateAndTime.DateDiff Méthode

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

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

Paramètres

Retours

Valeur longue spécifiant le nombre d’intervalles de temps entre deux valeurs Date.

Exceptions

Exemples

Cet exemple utilise la fonction DateDiff pour afficher le nombre de jours entre une date donnée et aujourd’hui.

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

Remarques

Vous pouvez utiliser la fonction DateDiff pour déterminer le nombre d’intervalles de temps spécifiés entre deux valeurs de date/heure. Par exemple, vous pouvez utiliser DateDiff pour calculer le nombre de jours entre deux dates ou le nombre de semaines entre aujourd’hui et la fin de l’année.

Comportement

• Traitement des paramètres. DateDiff soustrait la valeur de Date1 de la valeur de Date2 pour produire la différence. Aucune valeur n’est modifiée dans le programme appelant.

• Retourne des valeurs. Étant donné que Date1 et Date2 sont du type de données Date, ils contiennent des valeurs de date et d’heure exactes à 100 nanosecondes sur le minuteur système. Toutefois, DateDiff retourne toujours le nombre d’intervalles de temps sous la forme d’une valeur Long.

  Si Date1 représente une date et une heure ultérieures à Date2, DateDiff retourne un nombre négatif.

• Intervalles de jour. Si Interval est défini sur DateInterval.DayOfYear, il est traité comme DateInterval.Day, car DayOfYear n’est pas une unité significative pour un intervalle de temps.

• Intervalles de semaine. Si Interval est définie sur DateInterval.WeekOfYear, la valeur de retour représente le nombre de semaines entre le premier jour de la semaine contenant Date1 et le premier jour de la semaine contenant Date2. L’exemple suivant montre comment cela produit des résultats différents de 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)
  

  Dans l’exemple précédent, DateDiff retourne 0 à wD car la différence entre les deux dates est inférieure à sept jours, mais elle retourne 1 à wY car il existe une différence de sept jours entre les premiers jours des semaines civiles respectives.

• Intervalles plus importants. Si Interval est défini sur DateInterval.Year, la valeur de retour est calculée uniquement à partir des parties d’année de Date1 et de Date2. De même, la valeur de retour pour DateInterval.Month est calculée uniquement à partir des parties année et mois des arguments, et pour DateInterval.Quarter des trimestres contenant les deux dates.

  Par exemple, lors de la comparaison du 31 décembre au 1er janvier de l’année suivante, DateDiff retourne 1 pour DateInterval.Year, DateInterval.Quarterou DateInterval.Month, même si au plus un jour s’est écoulé.

  Pour les cultures telles que les japonais qui ont plusieurs ères, la méthode DateDiff ne retourne pas de différence en années si la différence s’étend sur deux ou plusieurs ères. Au lieu de cela, vous pouvez calculer la différence dans les valeurs retournées par la propriété Year, comme illustré dans l’exemple suivant : date2.Year - date1.Year.

• Autres intervalles. Étant donné que chaque valeur Date est prise en charge par une structure de DateTime, ses méthodes vous offrent des options supplémentaires dans la recherche d’intervalles de temps. Par exemple, vous pouvez utiliser la méthode Subtract dans l’une de ses formes surchargées : DateTime.Subtract soustrait une TimeSpan d’une variable Date pour retourner une autre valeur Date et DateTime.Subtract soustrait une valeur Date pour retourner un TimeSpan. Vous pouvez timer un processus pour déterminer le nombre de millisecondes qu’il prend, comme l’illustre l’exemple suivant.

  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’argument Interval peut avoir l’un des paramètres suivants.

L’argument DayOfWeek peut avoir l’un des paramètres suivants.

L’argument WeekOfYear peut avoir l’un des paramètres suivants.

Voir aussi

• DateAdd
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• TimeSpan
• résumé du type de données (Visual Basic)

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

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

Paramètres

Retours

Valeur longue spécifiant le nombre d’intervalles de temps entre deux valeurs Date.

Exceptions

Exemples

Cet exemple utilise la fonction DateDiff pour afficher le nombre de jours entre une date donnée et aujourd’hui.

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

Remarques

Vous pouvez utiliser la fonction DateDiff pour déterminer le nombre d’intervalles de temps spécifiés entre deux valeurs de date/heure. Par exemple, vous pouvez utiliser DateDiff pour calculer le nombre de jours entre deux dates ou le nombre de semaines entre aujourd’hui et la fin de l’année.

Comportement

• Traitement des paramètres. DateDiff soustrait la valeur de Date1 de la valeur de Date2 pour produire la différence. Aucune valeur n’est modifiée dans le programme appelant.

• Retourne des valeurs. Étant donné que Date1 et Date2 sont du type de données Date, ils contiennent des valeurs de date et d’heure exactes à 100 nanosecondes sur le minuteur système. Toutefois, DateDiff retourne toujours le nombre d’intervalles de temps sous la forme d’une valeur Long.

  Si Date1 représente une date et une heure ultérieures à Date2, DateDiff retourne un nombre négatif.

• Intervalles de jour. Si Interval est défini sur DateInterval.DayOfYear, il est traité comme DateInterval.Day, car DayOfYear n’est pas une unité significative pour un intervalle de temps.

• Intervalles de semaine. Si Interval est définie sur DateInterval.WeekOfYear, la valeur de retour représente le nombre de semaines entre le premier jour de la semaine contenant Date1 et le premier jour de la semaine contenant Date2. L’exemple suivant montre comment cela produit des résultats différents de 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)
  

  Dans l’exemple précédent, DateDiff retourne 0 à wD car la différence entre les deux dates est inférieure à sept jours, mais elle retourne 1 à wY car il existe une différence de sept jours entre les premiers jours des semaines civiles respectives.

• Intervalles plus importants. Si Interval est défini sur DateInterval.Year, la valeur de retour est calculée uniquement à partir des parties d’année de Date1 et de Date2. De même, la valeur de retour pour DateInterval.Month est calculée uniquement à partir des parties année et mois des arguments, et pour DateInterval.Quarter des trimestres contenant les deux dates.

  Par exemple, lors de la comparaison du 31 décembre au 1er janvier de l’année suivante, DateDiff retourne 1 pour DateInterval.Year, DateInterval.Quarterou DateInterval.Month, même si au plus un jour s’est écoulé.

  Pour les cultures telles que les japonais qui ont plusieurs ères, la méthode DateDiff ne retourne pas de différence en années si la différence s’étend sur deux ou plusieurs ères. Au lieu de cela, vous pouvez calculer la différence dans les valeurs retournées par la propriété Year, comme illustré dans l’exemple suivant : date2.Year - date1.Year.

• Autres intervalles. Étant donné que chaque valeur Date est prise en charge par une structure de DateTime, ses méthodes vous offrent des options supplémentaires dans la recherche d’intervalles de temps. Par exemple, vous pouvez utiliser la méthode Subtract dans l’une de ses formes surchargées : DateTime.Subtract soustrait une TimeSpan d’une variable Date pour retourner une autre valeur Date et DateTime.Subtract soustrait une valeur Date pour retourner un TimeSpan. Vous pouvez timer un processus pour déterminer le nombre de millisecondes qu’il prend, comme l’illustre l’exemple suivant.

  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’argument Interval peut avoir l’un des paramètres suivants.

L’argument DayOfWeek peut avoir l’un des paramètres suivants.

L’argument WeekOfYear peut avoir l’un des paramètres suivants.

Voir aussi

• DateAdd
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• TimeSpan
• résumé du type de données (Visual Basic)