Home / Autodocs / dos.library
NAME
- DateStamp
-
Obtain the date and time in internal format
SYNOPSIS
ds = DateStamp( ds );
D0 D1
struct DateStamp *DateStamp(struct DateStamp *)
D0 D1
struct DateStamp *DateStamp(struct DateStamp *)
FUNCTION
DateStamp() takes a structure of the same name and fills it in:
The first element (ds_Days) is a count of the number of days since January 1, 1978. The second element (ds_Minute) is the number of minutes elapsed in the day, past midnight. The third (ds_Tick) is the number of ticks elapsed in the current minute.
A tick happens 50 times a second. Note that the number of ticks per second is a preset constant and not in any way affected by the display refresh rate (vertical blanking frequency) or the AC power supply frequency.
DateStamp() ensures that the day and minute are consistent. All three elements are zero if the date is unset.
struct DateStamp {
};
LONG ds_Days;
LONG ds_Minute;
LONG ds_Tick;
LONG ds_Minute;
LONG ds_Tick;
A tick happens 50 times a second. Note that the number of ticks per second is a preset constant and not in any way affected by the display refresh rate (vertical blanking frequency) or the AC power supply frequency.
DateStamp() ensures that the day and minute are consistent. All three elements are zero if the date is unset.
INPUTS
- ds
-
pointer a struct DateStamp
RESULT
The DateStamp structure is filled as described and its address is returned (for pre-V36 compatibility).
NOTES
It is not safe to call this function from a Task!
Prior to V36 DateStamp() would only return even multiples of 50 ticks. Therefore, the time you got was always an even number of ticks. This is no longer the case with V36 and beyond.
Prior to V36 DateStamp() would only return even multiples of 50 ticks. Therefore, the time you got was always an even number of ticks. This is no longer the case with V36 and beyond.