The DateTime library is written by Josef Franz Vögel. It extends the clock routines with date and time calculation.
The following functions are available:
Returns the day of the week |
|
Returns the day of the year |
|
Returns the second of the day |
|
Returns the elapsed Seconds to a former assigned time-stamp |
|
Returns a number, which represents the System Day |
|
Returns a Number, which represents the System Second |
|
Returns the elapsed Seconds to a earlier assigned system-time-stamp |
|
Returns a time-value (String or 3 Byte for Second, Minute and Hour) depending of the Type of the Target |
|
Returns a date-value (String or 3 Bytes for Day, Month and Year) depending of the Type of the Target |
Date and time not to be confused with Date$ and Time$ !
The date starts at 1.1.2000 and valid from 2000 to 2099
If you wish to convert to NTP which starts at 1.1.1970, which is 30 years earlier, you need to subtract a value of 946684800
BASCOM DATE_TIME = NTP - 946684800
Most of the Date and Time functions accept variables which must be in sequential memory order. Like bSec, bMin, bHour
When using DIM like this : Dim bSec As Byte, bMin As Byte, bHour As byte , the variables will be in sequential order, but this might change in the future.
Better would be to be explicit : Dim bSec as byte , bMin as byte at bSec + 1 , bHour as byte at bMin + 1
This will ensure that the bytes will be mapped in the right order.
It is important that you use the CONFIG CLOCK option since this will include the date time library.
See also