<cDateTime>.DateDiff

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Language > thinBasic Functions > Date and Time > cDateTime > cDateTime_Methods >

<cDateTime>.DateDiff

 

Description

 

Compares only dates of two cDateTime objects.

 

Syntax

 

<cDateTime>.DateDiff(otherCDateTime)

 

Returns

 

None.

 

Parameters

 

Name

Type

Optional

Meaning

otherCDateTime

cDateTime

No

Other cDateTime object to compare date with.

 

Remarks

 

Restrictions

 

See also

 

Examples

 

' Create an object with current date and time

Dim firstDateTime As New cDateTime

 

' Set its values

firstDateTime.NewDate(2020, 12, 24)

firstDateTime.NewTime(20, 0, 0)

 

' Create another object with current date and time

Dim secondDateTime As New cDateTime

 

' Set its values

secondDateTime.NewDate(2021, 11, 25)

secondDateTime.NewTime(20, 30, 0)

 

Dim diffDate As DateInterval

 

' Calculate difference in DATE ONLY

diffDate = firstDateTime.DateDiff(secondDateTime)

 

' Display difference - in this case it will be 0 years, 11 months and 1 days

' The 0 years might be of surprise (2020 vs. 2021), but it is correct:

' total time difference is less than one year

MsgBox 0, "Years: " + diffDate.Years  + $CRLF + 

          "Months:" + diffDate.Months + $CRLF + 

          "Days:"   + diffDate.Days   + $CRLF