DBPTIME - A Third Party DLL

Download it here (53k)
Example Program (2k)

OVERVIEW
- This plugin adds many new Date and Time commands to DarkBASIC Professional.

INSTALLATION
- Simply drop DBPTIME.DLL into your "[DBPro Dir]/Compiler/plugins-user" directory.
- You can also add syntax highlighting to the editor. To add this, add "DBPTIME.ini" to the "[DBPro Dir]/Editor/Keywords" directory.

USAGE
- Simply use like normal DBPro commands. Below is a summary of the new commands, their usage and their function.

REFERENCE
GetSeconds [no parameters]
» Gets number of seconds of current minute. 00-59

GetHours [no parameters]
» Gets the current hour number. 00-23

GetMinutes [no parameters]
» Gets number of minutes past current hour. 00-59

GetMonth [no parameters]
» Gets current month. 01-12

GetDayWeek [no parameters]
» Gets the day of the week. Returns integer 1-7

GetDayMonth [no parameters]
» Gets the day of the month. Returns integer 01-31

GetYear [no parameters]
» Returns the current year, eg. 2004

GetDST [no parameters]
» Returns '1' when Daylight Savings is in effect, 0 otherwise. -1 when not available.

GetDayYear [no parameters]
» Gets the day of the year. 001-356

GetAMPM [no parameters]
» Returns either "AM" or "PM", depending on the time of day

Format [FormatString$, required]
» Formats a string as a time phrase. The formatting is dependant on the FormatString$. Specific tokens will be replaced with certain date/time phrases.
Example usage:
print format("Today is %A, day %d of %B in the year %Y.")

The following tokens can be used to build your FormatString$:

%a
Abbreviated weekday name
%A
Full weekday name
%b
Abbreviated month name
%B
Full month name
%c
Date and time representation appropriate for locale
%d
Day of month as decimal number (01 – 31)
%H
Hour in 24-hour format (00 – 23)
%I
Hour in 12-hour format (01 – 12)
%j
Day of year as decimal number (001 – 366)
%m
Month as decimal number (01 – 12)
%M
Minute as decimal number (00 – 59)
%p
Current locale’s A.M./P.M. indicator for 12-hour clock
%S
Second as decimal number (00 – 59)
%U
Week of year as decimal number, with Sunday as first day of week (00 – 53)
%w
Weekday as decimal number (0 – 6; Sunday is 0)
%W
Week of year as decimal number, with Monday as first day of week (00 – 53)
%x
Date representation for current locale
%X
Time representation for current locale
%y
Year without century, as decimal number (00 – 99)
%Y
Year with century, as decimal number
%z, %Z
Time-zone name or abbreviation; no characters if time zone is unknown
%%
Percent sign