Welcome to DateTime Library’s documentation!
Introduction
Overview
DateTime is a library which provides simple date and time conversion, manipulation and comparison functions for use in any of your projects.
Download
The DateTime Library, both x86 and x64 versions, are available to download from the github repository at github.com/mrfearless/DateTime-Library
Features
Conversion of date time strings to dword or Julian Date
Comparison of date time strings to determine if one is greater than the other
Difference calculation of date time strings and return as days difference - or +
Leap year calculation
Day of the week calculation
Installation
The DateTime Library are available as both x86 and x64 versions.
See the Installation & Setup section for more details.
Contribute
If you wish to contribute, please follow the Contributing guide for details on how to add or edit, the DateTime Library source or documentation.
Frequently Asked Questions
Please visit the Frequently Asked Questions section for details.
Installation & Setup
MASM for 32bit assembler
Download and install the MASM32 package.
Download the 32bit version of the DateTime Library: DateTime-x86.zip
Copy the
DateTime.incfile toX:\MASM32\Includefolder overwriting any previous versions.Copy the
DateTime.libfile toX:\MASM32\Libfolder overwriting any previous versions.
Note
X is the drive letter where the MASM32 package has been installed to.
Adding DateTime Library to your MASM project
You are now ready to begin using the DateTime library in your Masm projects. Simply add the following lines to your project:
include DateTime.inc
includelib DateTime.lib
UASM for 64bit assembler
Download and install the UASM assembler. Ideally you will have a setup that mimics the MASM32 setup, where you create manually folders for
bin,includeandlibDownload the 64bit version of the DateTime Library: DateTime-x64.zip
Copy the
DateTime.incfile toX:\UASM\Includefolder overwriting any previous versions.Copy the
DateTime.libfile toX:\UASM\Lib\x64folder overwriting any previous versions.
Note
X is the drive letter where the UASM package has been installed to.
Adding DateTime Library to your UASM project
You are now ready to begin using the DateTime library in your Uasm projects. Simply add the following lines to your project:
include DateTime.inc
includelib DateTime.lib
Note
See the following for more details on setting up UASM to work with RadASM and other details that may be useful in creating a development environment that mimics the MASM32 SDK: UASM-with-RadASM, UASM-SDK
Tip
UASM can be used as a x86 32 bit assembler as well.
Building
The DateTime Libraries (both x86 and x64 versions) come with RadASMs project to help you build the sources. However if you wish to build the libraries manually, here are the command line options you should use.
Building the DateTime Library x86
The DateTime Library x86 source consists of the following files:
DateTime.incDTDateFormat.asmDTDatesStringCompare.asmDTDateStringsDifference.asmDTDateTimeStringsDifference.asmDTDateTimeStringToDwordDateTime.asmDTDateTimeStringToJulianMillisec.asmDTDateTimeStringToUnixTime.asmDTDay.asmDTDayOfWeek.asmDTDwordDateTimeToDateTimeString.asmDTDwordDateTimeToJulianMillisec.asmDTDwordDateTimeToUnixTime.asmDTDwordDateToJulianDate.asmDTDwordTimeToMillisec.asmDTGetDateTime.asmDTIsLeapYear.asmDTJulianDateToDwordDate.asmDTJulianMillisecToDateTimeString.asmDTJulianMillisecToDwordDateTime.asmDTMillisecToDwordTime.asmDTMonth.asmDTUnixTimeToDateTimeString.asmDTUnixTimeToDwordDateTime.asmDTYear.asm
Building with Microsoft MASM (ML.EXE):
ML.EXE /c /coff /Cp /nologo /I"X:\MASM32\Include" *.asm
Note
X is the drive letter where the MASM32 package has been installed to.
Linking with Microsoft Library Manager (LIB.EXE):
LIB *.obj /out:DateTime.lib
Building the DateTime Library x86 Debug Build
To build the DateTime Library x86 with debug information, supply the additional flag options /Zi /Zd on the command line for MASM (ML.EXE) like so:
ML.EXE /c /coff /Cp /Zi /Zd /nologo /I"X:\MASM32\Include" *.asm
Note
X is the drive letter where the MASM32 package has been installed to.
Building the DateTime Library x64
The DateTime Library x64 source consists of the following files:
DateTime.incDTDateFormat.asmDTDatesStringCompare.asmDTDateStringsDifference.asmDTDateTimeStringsDifference.asmDTDateTimeStringToQwordDateTime.asmDTDateTimeStringToJulianMillisec.asmDTDateTimeStringToUnixTime.asmDTDay.asmDTDayOfWeek.asmDTGetDateTime.asmDTIsLeapYear.asmDTJulianDateToQwordDate.asmDTJulianMillisecToDateTimeString.asmDTJulianMillisecToQwordDateTime.asmDTMillisecToQwordTime.asmDTMonth.asmDTQwordDateTimeToDateTimeString.asmDTQwordDateTimeToJulianMillisec.asmDTQwordDateTimeToUnixTime.asmDTQwordDateToJulianDate.asmDTQwordTimeToMillisec.asmDTUnixTimeToDateTimeString.asmDTUnixTimeToQwordDateTime.asmDTYear.asm
Building with UASM (UASM64.EXE):
UASM64.EXE /c -win64 -Zp8 /win64 /D_WIN64 /Cp /nologo /W2 /I"X:\UASM\Include" *.asm
Note
X is the drive letter where the UASM assembler has been installed to.
Linking with Microsoft Library Manager (LIB.EXE):
LIB *.obj /out:DateTime.lib
Building the DateTime Library x64 Debug Build
To build the DateTime Library x64 with debug information, supply the additional flag options /Zi /Zd on the command line for UASM (UASM64.EXE) like so:
UASM64.EXE /c -win64 -Zp8 /Zi /Zd /win64 /D_WIN64 /Cp /nologo /W2 /I"X:\UASM\Include" *.asm
Contributing
To contribute to the DateTime Library source code or documentation you will need to have a Github account. Sign up at www.Github.com if you don’t have a Github account already.
Requirements
DateTime Library uses RadASM IDE for the projects hosted in the DateTime-x86 folder and the DateTime-x64 folder.
For x86 assembler projects:
Install RadASM
Install MASM32 SDK
For x64 assembler projects:
Install UASM
Install UASM-for-RadASM
Install UASM-SDK
DateTime Library uses readthedocs for hosting the documentation. This requires the installation of python, and some python extensions.
Install Python
Open a command prompt/terminal and type :
pip install sphinxpip install sphinx_rtd_themepip install recommonmark
DateTime Library Github Repository
To work with the DateTime Library source and/or documentation files you will need to first clone or fork the DateTime Library repository using a git GUI client or using git commands in a command prompt/terminal. The DateTime Library repository is located at: https://github.com/mrfearless/DateTime-Library
The workflow for users is:
For users who are already authorized contributors:
Clone the DateTime Library repository locally
Make changes
Commit changes back to the DateTime Library repository
For users who are not authorized contributors, but who wish to contribute:
Fork the DateTime Library repository to your own github account.
Clone that repository locally
Make changes
Commit changes back to your version hosted on your account
Submit a pull request - which will generate a pending commit on the original DateTime Library repository. This pending commit can be reviewed by the Author and/or other authorized persons and accepted or rejected.
At some later stage, if changes have occurred on the DateTime Library repository, and if you are to keep up to date with these changes, then instead of deleting your repo version and reforking the DateTime Library, you can rebase your version to sync with the latest changes. Some GUI git clients may offer this as an upstream, which will allow you to sync with the main repository.
Editing the DateTime Library source files
Once the requirements above have been met and the repository has been cloned/forked, you are ready to edit and make changes to the DateTime Library source files:
The DateTime Library source and RadASM project for MASM x86 assembler are stored in DateTime-x86 folder.
The DateTime Library source and RadASM project for UASM x64 assembler are stored in DateTime-x64 folder.
Make your edits to the source files, and then once finished you are ready to submit changes
Editing the DateTime Library documentation files
The DateTime Library documentation is stored in the docs folder. All the files in that folder and sub-folders are .rst files (reStructuredText) and are similar to markdown files. See the reStructuredText Primer for details of usage.
Once any changes you have made are saved, you can preview the changes locally by generating the html files:
Open a command prompt/terminal and change to the DateTime Library docs directory (for example:
cd "c:\Github\DateTime-Library\docs")Generate the html files by typing
make html
The sphinx builder will create a build folder inside the DateTime Library docs folder automatically (if it doesn’t exist already) and will create an html folder under that. Inside this html folder is the html files including the index.html which you can open to locally preview your changes.
Note
The build folder won’t be included in any pull requests or commits, as its automatically ignored. You can safely ignore this folder, or delete it if you wish, as it will be built automatically each time you run make html
Submitting Changes
Once your happy with your changes, you can then commit to your locally cloned repository and submit a pull request on the DateTime Library on the Github website on your Github account. For authorized contributors you can just commit directly to the DateTime Library repository.
Frequently Asked Questions
What does DateTime Library do?
DateTime is a library which provides simple date and time conversion, manipulation and comparison functions for use in any of your assembler projects.
What do I need to do to install DateTime Library?
Please follow the Installation & Setup guide for details on how to install the DateTime Library for your particular assembler versions that you are using.
How do I add to the DateTime Library documentation?
Please follow the Contributing guide for details on how to add to, or edit, the DateTime Library documentation.
How do I report a bug?
If you should encounter any bugs, please open a new issue on the DateTime Library Github repository.
I need more information on date and time algorithms
Here are some useful links for gregorian, julian, millisec, unixtime topics & algorithms:
Julian Day Numbers for dates on the Gregorian and Julian Calendars by Kelley L. Ross |
Time format conversions SYSTEMTIME to FILETIME to SQL time string to Unix time_t by John Stewien |
DateTime Functions x86
DTDateFormat
Converts a SYSTEMTIME structure, pointed to by the lpSystermtimeStruct parameter, to a date & time string, into the buffer pointed to by the lpszDateTimeString parameter and returns it formatted as specified by the DateFormat parameter.
DTDateFormat PROTO lpSystermtimeStruct:DWORD, lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpSystermtimeStruct- Pointer to a SYSTEMTIME type that contains date & time information to convert.lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file:; Reverse Date Formats CCYYMMDDHHMMSSMS EQU 1 ; Example 1974/03/27 14:53:01:00 CCYYMMDDHHMMSS EQU 2 ; Example 1974/03/27 14:53:01 CCYYMMDDHHMM EQU 3 ; Example 1974/03/27 14:53 CCYYMMDDHH EQU 4 ; Example 1974/03/27 14:53 CCYYMMDD EQU 5 ; Example 1974/03/27 CCYYMM EQU 6 ; Example 1974/03 YEAR EQU 7 ; Example 1974 ; British Date Formats DDMMCCYYHHMMSSMS EQU 8 ; Example 27/03/1974 14:53:01:00 DDMMCCYYHHMMSS EQU 9 ; Example 27/03/1974 14:53:01 DDMMCCYYHHMM EQU 10 ; Example 27/03/1974 14:53 DDMMCCYY EQU 11 ; Example 27/03/1974 DDMM EQU 12 ; Example 27/03 DAY EQU 13 ; Example 27 ; American Date Formats MMDDCCYYHHMMSSMS EQU 14 ; Example 03/27/1974 14:53:01:00 MMDDCCYYHHMMSS EQU 15 ; Example 03/27/1974 14:53:01 MMDDCCYYHHMM EQU 16 ; Example 03/27/1974 14:53 MMDDCCYY EQU 17 ; Example 03/27/1974 MMDD EQU 18 ; Example 03/27 MONTH EQU 19 ; Example 03 ; Reverse Without Century Date Formats YYMMDDHHMMSSMS EQU 20 ; Example 74/03/27 14:53:01:00 YYMMDDHHMMSS EQU 21 ; Example 74/03/27 14:53:01 YYMMDDHHMM EQU 22 ; Example 74/03/27 14:53 YYMMDD EQU 23 ; Example 74/03/27 YYMM EQU 24 ; Example 74/03 YY EQU 25 ; Example 74 ; Other Date Formats MMDDYY EQU 26 ; Example 03/27/74 DDMMYY EQU 27 ; Example 27/03/74 DAYOFWEEK EQU 28 ; Example Monday ; Time Formats HHMMSSMS EQU 29 ; Example 14:53:01 HHMMSS EQU 30 ; Example 14:53:01 HHMM EQU 31 ; Example 14:53 HH EQU 32 ; Example 14 ; Useful Named Constants TODAY EQU DDMMCCYYHHMMSS NOW EQU DDMMCCYYHHMMSS TIME EQU HHMM ; Named Date Constants AMERICAN EQU MMDDYY BRITISH EQU DDMMYY FRENCH EQU DDMMYY JAPAN EQU YYMMDD TAIWAN EQU YYMMDD MDY EQU MMDDYY DMY EQU DDMMYY YMD EQU YYMMDD
Note
Constants: CC=Century, YY=Year, MM=Month, DD=Day, HH=Hours, MM=Minutes, SS=Seconds, MS=Milliseconds, DOW=Day Of Week
Returns
Returns in EAX TRUE if succesful, or FALSE otherwise.
Notes
The user is responsible for ensuring the buffer pointed to by the lpszDateTimeString parameter is large enought to hold the date & time string value. Recommeneded minimum size for the buffer is 24 bytes long as defined by the DATETIME_STRING constant.
Example
.data
LocalDateTime SYSTEMTIME <>
szDataAndTimeString DB DATETIME_STRING DUP (0)
.code
Invoke GetLocalTime, Addr LocalDateTime
Invoke DTDateFormat, Addr LocalDateTime, Addr szDataAndTimeString, DDMMYY
See Also
DTDateStringsCompare
Compare two date & time strings to determine if they are: equal in value, one is less than another, or one is greater than another.
DTDateStringsCompare PROTO lpszDateTimeString1:DWORD, lpszDateTimeString2:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString1- Pointer to a buffer containing the first date & time string to compare. The format of the date & time string is determined by theDateFormatparameter.lpszDateTimeString2- Pointer to a buffer containing the second date & time string to compare. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to by both thelpszDateTimeString1parameter and thelpszDateTimeString2parameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Return values in EAX indicate the following:
-1First date is less than second date.0First date is equal to second date.+1First date is greater than second date.
Notes
The date & time string pointed to by the lpszDateTimeString1 parameter is compared against the date & time string pointed to by the lpszDateTimeString2 parameter.
Both dates are converted to DWORD values internally before the comparison to see which is greater or less than or equal.
If a date & time string contains time information this will be ignored.
Example
Invoke DTDateStringsCompare, Addr szDateTime1, Addr szDateTime2, CCYYMMDD
See Also
DTDateStringsDifference, DTDateTimeStringsDifference, DateTime Formats
DTDateStringsDifference
Returns the difference in days of the first date & time string to the second date & time string.
DTDateStringsDifference PROTO lpszDateTimeString1:DWORD, lpszDateTimeString2:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString1- Pointer to a buffer containing the first date & time string. The format of the date & time string is determined by theDateFormatparameter.lpszDateTimeString2- Pointer to a buffer containing the second date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to by both thelpszDateTimeString1parameter and thelpszDateTimeString2parameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return EAX contains the difference between the two dates in days as an integer, either positive or negative.
Notes
The date & time string pointed to by the lpszDateTimeString1 parameter is compared against the date & time string pointed to by the lpszDateTimeString2 parameter to determine the difference of the dates.
Both dates are converted to Julian date format internally before comparing the days difference between dates.
If a date & time string contains time information this will be ignored.
Example
.data
CurrentDateTime db DATETIME_STRING dup (0)
SomeOtherDateTime db "2008/03/21",0
.data?
DayDifference dd ?
.code
Invoke DTGetDateTime, Addr CurrentDateTime, CCYYMMDD
Invoke DTDateStringsDifference, Addr CurrentDateTime, Addr SomeOtherDateTime, CCYYMMDD
mov DayDifference, eax ; save day difference to data variable
.IF eax == 0
; No difference in dates, do something...
.ELSE
; Day difference is - or +, do something else...
.ENDIF
See Also
DTDateStringsCompare, DTDateTimeStringsDifference, DateTime Formats
DTDateTimeStringToDwordDateTime
Converts a formatted date & time string to DWORD values. On return EAX contains the date information and EDX the time information.
DTDateTimeStringToDwordDateTime PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to convert toDWORDvalues. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return EAX will contain the date information in the following format:
EAX Register Bits:
+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
On return EDX will contain the time information in the following format:
EDX Register Bits:
+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Notes
The registers always return the information in the format shown in the tables above, and do not change regardless of the DateFormat parameter.
The DateFormat parameter is used to indicate the format of the date & time string being passed to DTDateTimeStringToDwordDateTime.
Some information may be unavailable to convert if the passed DateTime string does not contain enough information. For example if only year information is in the DateTime string, then the DWORD date and DWORD time will be based only on that.
To prevent this, always pass a full date time string of CCYYMMDDHHMMSSMS format or similar (DDMMCCYYHHMMSSMS or MMDDCCYYHHMMSSMS)
To retrieve the various values of the date & time DWORD values you can use the following as an example:
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
DateValue dd ?
TimeValue dd ?
CentYear dd ?
Year dd ?
Month dd ?
Day dd ?
.code
Invoke DTDateTimeStringToDwordDateTime, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov DateValue, eax ; Save date info in eax to a data variable
mov TimeValue, edx ; Save time info in edx to a data variable
; save day, month, year and century info to data variables
mov edx, DateValue ; use edx as our work place
xor eax, eax ; clear register
mov al, dl ; dl contains day info
mov Day, eax ; save day info DD in dl to a data variable
xor eax, eax ; clear register
mov al, dh ; dh contains month info
mov Month, eax ; save month info MM in dh to a data variable
shr edx, 16 ; century and year are now in dx part of the register
mov CentYear, edx ; save century and year info CCYY to a data variable
xor eax, eax ; clear register
mov al, dl ; dl contains YY part of year
mov Year, eax ; save year info in dl to a data variable
See Also
DTDwordDateTimeToDateTimeString, DateTime Formats, DTGetDateTime
DTDateTimeStringToJulianMillisec
Converts a formatted date & time string to a Julian date integer in EAX and milliseconds in EDX
DTDateTimeStringToJulianMillisec PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to convert to Julian date integer and millisec values. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return EAX contains Julian date integer value representing the date specified and EDX will contain the total time in milliseconds.
Notes
Some information may be unavailable to convert if the passed DateTime string does not contain enough information. For example if only year information is in the DateTime string, then the Julian date and millisec time will be based only on that.
To prevent this, always pass a full date time string of CCYYMMDDHHMMSSMS format or similar (DDMMCCYYHHMMSSMS or MMDDCCYYHHMMSSMS)
The Julian Day Count is a uniform count of days from a remote epoch in the past (-4712 January 1, 12 hours Greenwich Mean Time (Julian proleptic Calendar) = 4713 BCE January 1, 12 hours GMT (Julian proleptic Calendar) At this instant, the Julian Day Number is 0.
The Julian Day Count has nothing to do with the Julian Calendar introduced by Julius Caesar. It is named for Julius Scaliger, the father of Josephus Justus Scaliger, who invented the concept. It can also be thought of as a logical follow-on to the old Egyptian civil calendar, which also used years of constant lengths.
Scaliger chose the particular date in the remote past because it was before recorded history and because in that year, three important cycles coincided with their first year of the cycle: The 19-year Metonic Cycle, the 15-year Indiction Cycle (a Roman Taxation Cycle) and the 28-year Solar Cycle (the length of time for the old Julian Calendar to repeat exactly).
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
JulianDateValue dd ?
TotalMilliseconds dd ?
.code
Invoke DTDateTimeStringToJulianMillisec, Addr DateTimeStringValue
mov JulianDateValue, eax ; save julian date value to data variable
mov TotalMilliseconds, edx ; save total milliseconds to data variable
Example
.data?
dwDate1 dd ?
dwDate2 dd ?
.code
;==========================================================================================
; Example to calculate difference in 2 date values over month boundary
Invoke DTDateTimeStringToJulianMillisec, CTEXT("27/02/2009"), DDMMCCYY
mov dwDate1, eax ; save dword date portion to variable, ignore edx which contains time info
Invoke DTDateTimeStringToJulianMillisec, CTEXT("03/03/2009"), DDMMCCYY
mov dwDate2, eax ; save dword date portion to variable, ignore edx which contains time info
mov ebx, dwDate1 ; Place date1 in ebx
sub eax, ebx ; subtract date2 from date1, eax = 4 days
;==========================================================================================
; Another example to calculate difference in weeks between 2 date values
Invoke DTDateTimeStringToJulianMillisec, CTEXT("03/01/2009"), DDMMCCYY
mov dwDate1, eax ; save dword date portion to variable, ignore edx which contains time info
Invoke DTDateTimeStringToJulianMillisec, CTEXT("10/01/2009"), DDMMCCYY
mov dwDate2, eax ; save dword date portion to variable, ignore edx which contains time info
mov ebx, dwDate1 ; Place date1 in ebx
sub eax, ebx ; subtract date2 from date1, eax = 7 days
xor edx, edx ; clear edx for division
mov ecx, 7d ; Divisor is 7 in ecx
div ecx ; divide eax by 7, eax = 1
See Also
DTDateTimeStringToUnixTime
Converts a formatted date & time string to a DWORD value containing a unix time integer value.
DTDateTimeStringToUnixTime PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to convert to aDWORDvalue containing a unix time integer value. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return EAX contains the unix time as a DWORD value.
Notes
Some information may be unavailable to convert if the passed DateTime string does not contain enough information. For example if only year information is in the DateTime string, then the UnixTime will be based only on that.
To prevent this, always pass a full date time string of CCYYMMDDHHMMSSMS format or similar (DDMMCCYYHHMMSSMS or MMDDCCYYHHMMSSMS)
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
The UNIXTIMESTAMP format is a string representation of the unix time in integer format if used as the DateFormat value.
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
UnixTime dd ?
.code
Invoke DTDateTimeStringToUnixTime, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov UnixTime, eax ; save unix time value to data variable which should contain 1206116461
Example
.data
UnixTimeAsAStringValue db "1656241202",0 ; Sun Jun 26 2022 11:00
.data?
UnixTime dd ?
.code
Invoke DTDateTimeStringToUnixTime, Addr UnixTimeAsAStringValue, UNIXTIMESTAMP
mov UnixTime, eax ; save unix time value to data variable which should contain 1656241202
See Also
DTUnixTimeToDateTimeString, DTUnixTimeToDwordDateTime, DateTime Formats
DTDateTimeStringsDifference
Returns the difference in days or milliseconds of the first date & time string to the second date & time string.
DTDateTimeStringsDifference PROTO lpszDateTimeString1:DWORD, lpszDateTimeString2:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString1- Pointer to a buffer containing the first date & time string. The format of the date & time string is determined by theDateFormatparameter.lpszDateTimeString2- Pointer to a buffer containing the second date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to by both thelpszDateTimeString1parameter and thelpszDateTimeString2parameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return EAX contains the difference between the two dates in days as an integer, either positive or negative.
On return EDX contains the difference in time or 0, see notes below for details.
Notes
If both dates are the same date, then EAX will be 0. If both date & time strings contain time values and the DateFormat parameter specified also provides a time format, then EDX will contain the difference in time in milliseconds.
Example
.data
CurrentDateTime db DATETIME_STRING dup (0)
SomeOtherDateTime db "2008/03/21",0
.data?
DayDifference dd ?
MillisecDifference dd ?
.code
Invoke DTGetDateTime, Addr CurrentDateTime, CCYYMMDDHHMMSSMS
Invoke DTDateTimeStringsDifference, Addr CurrentDateTime, Addr SomeOtherDateTime, CCYYMMDDHHMMSSMS
mov DayDifference, eax ; save day difference to data variable
mov MillisecDifference, edx ; save millisec diff if days the same
.IF eax == 0
; No difference in dates
; So MillisecDifference can be used
.ELSE
; Day difference is - or +, do something else...
; MillisecDifference is 0 value
.ENDIF
See Also
DTDateStringsCompare, DTDateStringsDifference, DateTime Formats
DTDay
Get the day part of a date & time string.
DTDay PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to retrieve the day portion from. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns the day value in EAX
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
DayValue dd ?
.code
Invoke DTDay, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov DayValue, eax ; save day part of date value to data variable
; eax should contain 21
See Also
DTMonth, DTYear, DTIsLeapYear, DTDayOfWeek, DateTime Formats
DTDayOfWeek
Returns an integer indicating the day of the week from a date & time string.
DTDayOfWeek PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to check the day of the week for. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return EAX will contain a value to indicate the following day:
0= Monday1= Tuesday2= Wednesday3= Thursday4= Friday5= Saturday6= Sunday
Example
; The following example calculates the first day of the week from a date using the DTDayOfWeek function
.data
szDateTime db DATETIME_STRING dup (0)
.data?
dwDate1 dd ?
dwDayWeek dd ?
dwStartWeek dd ?
.code
Invoke DTDateTimeStringToJulianMillisec, CTEXT("04/06/2009"), DDMMCCYY ; Convert date to julian date
mov dwDate1, eax ; only save date info returned in eax, ignore time info returned in edx
Invoke DTDayOfWeek, CTEXT("04/06/2009"), DDMMCCYY ; Get day of week for date
mov dwDayWeek, eax ; Save the returned integer representing day 0-6
mov ebx, eax
mov eax, dwDate1
sub eax, ebx ; subtract julian date value from day of week integer
mov dwStartWeek, eax ; we have new julian date which is start of the week
Invoke DTJulianToDwordDate, dwStartWeek ; convert new julian date start of week number to a date in dword format
Invoke DTDwordDateTimeToDate, eax, NULL, Addr szDateTime, DDMMCCYY ; convert dword date format to a string value
; szDateTime now contains '01/06/2009'
See Also
DTDwordDateTimeToDateTimeString
Converts DWORD values containing date & time information to a formatted date & time string as specified by the DateFormat parameter.
DTDwordDateTimeToDateTimeString PROTO dwDate:DWORD, dwTime:DWORD, lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
dwDate-DWORDvalue containing Date information to convert to the date & time string
The format for the value containing the date information is as follows:
date
DWORDRegister Bits:+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
dwTime-DWORDvalue containing Time information to convert to the date & time string
The format for the value containing the time information is as follows:
time
DWORDRegister Bits:+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
No return value
Notes
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0) ; buffer to store date and time as string
DateValue dd 0
TimeValue dd 0
.code
xor eax, eax
mov eax, 1974 ; save year
shl eax, 16 ; move it into upper word of eax
mov ah, 03 ; save month
mov al, 15 ; save day
mov DateValue, eax
xor eax, eax
mov ah, 12 ; save hours
mov al, 34 ; save minutes
shl eax, 16 ; move it into upper word of eax
mov ah, 01 ; save seconds
mov al, 0 ; save milliseconds
mov TimeValue, eax
Invoke DTDwordDateTimeToDateTimeString, DateValue, TimeValue, Addr DateTimeStringValue, CCYYMMDDHHMMSS
; DateTimeStringValue will now contain "1974/03/15 12:36:01"
See Also
DTDateTimeStringToDwordDateTime, DateTime Formats, DTGetDateTime
DTDwordDateTimeToJulianMillisec
Converts DWORD values containing date & time information to Julian date and total milliseconds.
DTDwordDateTimeToJulianMillisec PROTO dwDate:DWORD, dwTime:DWORD
Parameters
dwDate-DWORDvalue containing date information to convert to Julian date.
The format for the value containing the date information is as follows:
date
DWORDRegister Bits:+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
dwTime-DWORDvalue containing time information to convert to the total milliseconds.
The format for the value containing the time information is as follows:
time
DWORDRegister Bits:+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Returns
On return EAX will contain the Julian date integer, and EDX the total millliseconds.
Notes
Example
Invoke DTDwordDateTimeToJulianMillisec, dwDate, dwTime
See Also
DTJulianMillisecToDwordDateTime, DTJulianDateToDwordDate, DTMillisecToDwordTime
DTDwordDateTimeToUnixTime
Converts DWORD values containing date & time information to a DWORD value containing a unix time integer value. On return EAX contains the unix time integer value.
DTDwordDateTimeToUnixTime PROTO dwDate:DWORD, dwTime:DWORD
Parameters
dwDate-DWORDvalue containing date information to convert to a unix time integer value.
The format for the value containing the date information is as follows:
date
DWORDRegister Bits:+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
dwTime-DWORDvalue containing time information to convert to a unix time integer value.
The format for the value containing the time information is as follows:
time
DWORDRegister Bits:+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Returns
On return EAX will contain the unix time integer value.
Notes
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
Example
Invoke DTDwordDateTimeToUnixTime, dwDate, dwTime
See Also
DTUnixTimeToDwordDateTime, DTDateTimeStringToUnixTime, DTUnixTimeToDateTimeString
DTDwordDateToJulianDate
Converts a DWORD value containing date information to a Julian date integer. On return EAX contains the date information in Julian Date format.
DTDwordDateToJulianDate PROTO dwDate:DWORD
Parameters
dwDate-DWORDvalue containing Date information to convert to a Julian date integer.
The format for the value containing the date information is as follows:
date
DWORDRegister Bits:+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
Returns
On return EAX contains Julian date integer value representing the date specified.
Notes
The Julian Day Count is a uniform count of days from a remote epoch in the past (-4712 January 1, 12 hours Greenwich Mean Time (Julian proleptic Calendar) = 4713 BCE January 1, 12 hours GMT (Julian proleptic Calendar) At this instant, the Julian Day Number is 0.
The Julian Day Count has nothing to do with the Julian Calendar introduced by Julius Caesar. It is named for Julius Scaliger, the father of Josephus Justus Scaliger, who invented the concept. It can also be thought of as a logical follow-on to the old Egyptian civil calendar, which also used years of constant lengths.
Scaliger chose the particular date in the remote past because it was before recorded history and because in that year, three important cycles coincided with their first year of the cycle: The 19-year Metonic Cycle, the 15-year Indiction Cycle (a Roman Taxation Cycle) and the 28-year Solar Cycle (the length of time for the old Julian Calendar to repeat exactly).
Example
.data
Day db 15
Month db 10
CentYear dw 1582
DateValue dd 0
.code
xor eax, eax
mov ax, CentYear
shl eax, 16 ; move year into upper word of eax
mov ah, Month ; move month into ah
mov al, Day ; move day into al
mov DateValue, eax
Invoke DTDwordDateToJulianDate, DateValue
; EAX now contains 2299161 which is the Julian Date for 1582 October 15
See Also
DTJulianDateToDwordDate, DTMillisecToDwordTime, DTDwordDateTimeToJulianMillisec, DTJulianMillisecToDwordDateTime
DTDwordTimeToMillisec
Converts a DWORD value containing time information to total amount of milliseconds.
DTDwordTimeToMillisec PROTO dwTime:DWORD
Parameters
dwTime-DWORDvalue containing time information to convert to total amount of milliseconds.
The format for the value containing the time information is as follows:
time
DWORDRegister Bits:+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Returns
On return EAX will contain the total milliseconds.
Example
Invoke DTDwordTimeToMillisec, dwTime
See Also
DTMillisecToDwordTime, DTJulianDateToDwordDate, DTDwordDateTimeToJulianMillisec, DTJulianMillisecToDwordDateTime
DTGetDateTime
Get the current date & time and return it as a formatted string as specified by the DateFormat parameter.
DTGetDateTime PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns in eax TRUE if succesful, or FALSE otherwise.
Notes
The user is responsible for ensuring the buffer pointed to by the lpszDateTimeString parameter is large enought to hold the date & time string value. Recommeneded minimum size for the buffer is 24 bytes long as defined by the DATETIME_STRING constant.
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0) ; buffer to store date and time as string
.code
Invoke DTGetDateTime, Addr DateTimeStringValue, CCYYMMDDHHMMSS
See Also
DTIsLeapYear
Calculate if a specified year is a leap year.
DTIsLeapYear PROTO dwYear:DWORD
Parameters
dwYear- aDWORDvalue that has the year value to check for leap year.
Returns
Returns TRUE if year is a leap year, otherwise FALSE.
Notes
dwYear must include the century. For example 2008 which in a DWORD value is stored as 0x7D8
A year will be a leap year if it is divisible by 4 but not by 100. If a year is divisible by 4 and by 100, it is not a leap year unless it is also divisible by 400.
Example
.data
CurrentDateTimeValue db 32 dup (0) ; buffer to store date & time as string
Year dd 0
.code
Invoke DTGetDateTime, Addr CurrentDateTimeValue, CCYYMMDDHHMMSS
Invoke DTYear, Addr CurrentDateTimeValue, CCYYMMDDHHMMSS
mov Year, eax ; save year
Invoke DTIsLeapYear, eax ; check leap year
.IF eax == TRUE
; Leap year, do something...
.ELSE
; No leap year, do something other...
.ENDIF
See Also
DTJulianDateToDwordDate
Converts a Julian Date number to a DWORD value containing date information. Uses CCYYMMDD DateTime Format
DTJulianDateToDwordDate PROTO JulianDate:DWORD
Parameters
JulianDate- ADWORDvalue containing the Julian date integer to convert to aDWORDformat inEAX
Returns
On return EAX will contain the date information in the following format:
EAX Register Bits:
+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
Notes
The Julian Day Count is a uniform count of days from a remote epoch in the past (-4712 January 1, 12 hours Greenwich Mean Time (Julian proleptic Calendar) = 4713 BCE January 1, 12 hours GMT (Julian proleptic Calendar) At this instant, the Julian Day Number is 0.
The Julian Day Count has nothing to do with the Julian Calendar introduced by Julius Caesar. It is named for Julius Scaliger, the father of Josephus Justus Scaliger, who invented the concept. It can also be thought of as a logical follow-on to the old Egyptian civil calendar, which also used years of constant lengths.
Scaliger chose the particular date in the remote past because it was before recorded history and because in that year, three important cycles coincided with their first year of the cycle: The 19-year Metonic Cycle, the 15-year Indiction Cycle (a Roman Taxation Cycle) and the 28-year Solar Cycle (the length of time for the old Julian Calendar to repeat exactly).
Example
.data
Day db 0
Month db 0
CentYear dw 0
.code
Invoke DTJulianDateToDwordDate, 2299161 ; Gregorian date of this Julian Date value is 1582 October 15
mov edx, eax
mov Month, ah
mov Day, al
shr eax, 16 ; move year info into lower word of eax
mov CentYear, ax
; 1582 October 15 - CentYear now contains 1582, Month contains 10, Day contains 15
See Also
DTJulianMillisecToDateTimeString
Converts a Julian date integer and millisec time to a formatted date & time string as specified by the DateFormat parameter.
DTJulianMillisecToDateTimeString PROTO JulianDate:DWORD, Milliseconds:DWORD, lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
JulianDate- ADWORDvalue containing the Julian date integer to convert to a gregorian date in the date & time string.Milliseconds- ADWORDvalue containting the total milliseconds to convert to hours, minutes, seconds and milliseconds in the date & time string.lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
There is no return value, the date & time string will contain the date & time as specified by the DateFormat parameter.
Notes
No time information is converted with the Julian date value, so if formatting outputs a time, it will be empty as in 00:00:00:00
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0) ; buffer to store date and time as string
.code
Invoke DTJulianMillisecToDateTimeString, 2299161, 0, Addr DateTimeStringValue, CCYYMMDDHHMMSS
; DateTimeStringValue now contains: 1582/10/15 00:00:00
See Also
DTJulianMillisecToDwordDateTime
Converts Julian date integer value and total milliseconds to DWORD values containing date and time information. On return EAX contains the date information and EDX the time information.
DTJulianMillisecToDwordDateTime PROTO JulianDate:DWORD, Milliseconds:DWORD
Parameters
JulianDate- ADWORDvalue containing the Julian date integer to convert to aDWORDdate inEAX.Milliseconds- ADWORDvalue containting the total milliseconds to convert to hours, minutes, seconds and milliseconds inDWORDtime inEDX.
Returns
On return EAX will contain the date information in the following format:
EAX Register Bits:
+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
On return EDX will contain the time information in the following format:
EDX Register Bits:
+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Notes
The registers always return the information in the format shown in the tables above.
Example
.data?
dwDate dd ?
dwTime dd ?
Year dw ?
Month db ?
Day db ?
Hours db ?
Minutes db ?
Seconds db ?
Millisec db ?
.code
Invoke DTJulianMillisecToDwordDateTime, 2299161, 0
mov dwDate, eax ; eax contains the date information
mov dwTime, edx ; edx contains the time information
mov eax, dwDate
shr eax, 16 ; move year into upper word of eax
mov Year, ax ; year
mov eax, dwDate
mov Month, ah ; month
mov Day, al ; day
mov eax, dwTime
shr eax, 16 ; move hour and minute into upper word of eax
mov Hours, ah ; hours
mov Minutes, al ; minutes
mov eax, dwTime
mov Seconds, ah ; seconds
mov Millisec, al ; millseconds
See Also
DTDwordDateTimeToJulianMillisec, DTDwordDateToJulianDate, DTDwordTimeToMillisec
DTMillisecToDwordTime
Converts total milliseconds to a DWORD value containing time information in hours, minutes, seconds and milliseconds.
DTMillisecToDwordTime PROTO Milliseconds:DWORD
Parameters
Milliseconds- ADWORDvalue containting the total milliseconds to convert to hours, minutes, seconds and milliseconds inDWORDtime inEAX.
Returns
On return EAX will contain the time information in the following format:
EAX Register Bits:
+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Notes
Example
Invoke DTMillisecToDwordTime, dwMilliseconds
See Also
DTDwordTimeToMillisec, DTDwordDateToJulianDate, DTDwordDateTimeToJulianMillisec, DTJulianMillisecToDwordDateTime
DTMonth
Get the month part of a date & time string.
DTMonth PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to retrieve the month portion from. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns the month value in EAX
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
MonthValue dd ?
.code
Invoke DTMonth, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov MonthValue, eax ; save month part of date value to data variable
; eax should contain 3
Example
.data?
dwMonth1 dd ?
dwMonth2 dd ?
.code
Invoke DTMonth, CTEXT("27/02/2009"), DDMMCCYY
mov dwMonth1, eax ; save month to variable
Invoke DTMonth, CTEXT("03/03/2009"), DDMMCCYY
mov dwMonth2, eax ; save month to variable
mov ebx, dwMonth1 ; place month1 variable in ebx
sub eax, ebx ; subtract month2 from month1, eax = 1 in this example
See Also
DTUnixTimeToDateTimeString
Converts a DWORD containing a unix time integer value to a formatted date & time string as specified by the DateFormat parameter.
DTUnixTimeToDateTimeString PROTO UnixTime:DWORD, lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
UnixTime-DWORDcontaining a unix time integer value to convert to a date & time string.lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
There is no return value, the date & time string will contain the date & time as specified by the DateFormat specified.
Notes
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
The UNIXTIMESTAMP format is a string representation of the unix time in integer format if used as the DateFormat value.
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0)
.code
Invoke DTUnixTimeToDateTimeString, 1276278420, Addr szDateTimeString, DDMMCCYYHHMMSSMS
; DateTimeString should now contain the string "11/06/2010 17:47:00:00"
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0)
.code
Invoke DTUnixTimeToDateTimeString, 1656241202, Addr szDateTimeString, UNIXTIMESTAMP
; DateTimeString should now contain the string "1656241202"
See Also
DTDateTimeStringToUnixTime, DTDwordDateTimeToUnixTime, DateTime Formats
DTUnixTimeToDwordDateTime
Converts a DWORD containing a unix time integer value to DWORD values containing date and time information.
DTUnixTimeToDwordDateTime PROTO UnixTime:DWORD
Parameters
UnixTime-DWORDcontaining a unix time integer value to convert toDWORDdate & time values.
Returns
On return EAX will contain the date information in the following format:
EAX Register Bits:
+------------------------+------------+-----------+ | WORD | BYTE | BYTE | +------------------------+------------+-----------+ | Bits 31-16 | Bits 15-8 | Bits 7-0 | +------------------------+------------+-----------+ | Century Year | Month | Day | +------------------------+------------+-----------+ | CCCCYY | MM | DD | +------------------------+------------+-----------+
On return EDX will contain the time information in the following format:
EDX Register Bits:
+------------+------------+-----------+-----------+ | BYTE | BYTE | BYTE | BYTE | +------------+------------+-----------+-----------+ | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +------------+------------+-----------+-----------+ | Hour | Minute | Second | Millisec | +------------+------------+-----------+-----------+ | HH | MM | SS | MS | +------------+------------+-----------+-----------+
Notes
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
Example
.data?
dwDate dd ?
dwTime dd ?
Year dw ?
Month db ?
Day db ?
Hours db ?
Minutes db ?
Seconds db ?
Millisec db ?
.code
Invoke DTUnixTimeToDwordDateTime, 1276278420
mov dwDate, eax ; eax contains the date information
mov dwTime, edx ; edx contains the time information
mov eax, dwDate
shr eax, 16 ; move year into upper word of eax
mov Year, ax ; year
mov eax, dwDate
mov Month, ah ; month
mov Day, al ; day
mov eax, dwTime
shr eax, 16 ; move hour and minute into upper word of eax
mov Hours, ah ; hours
mov Minutes, al ; minutes
mov eax, dwTime
mov Seconds, ah ; seconds
mov Millisec, al ; millseconds
See Also
DTDwordDateTimeToUnixTime, DTDateTimeStringToUnixTime, DTUnixTimeToDateTimeString
DTYear
Get the year part of a date & time string.
DTYear PROTO lpszDateTimeString:DWORD, DateFormat:DWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to retrieve the year portion from. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns the year value in EAX
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
YearValue dd ?
.code
Invoke DTYear, Addr DateTimeStringValue
mov YearValue Value, eax ; save year part of date value to data variable
; eax should contain 2008
See Also
Function |
Description |
Get the current date & time and return it as a formatted string |
|
Converts a |
|
Converts |
|
Converts a formatted date & time string to |
|
Converts a |
|
Converts a Julian Date number to a |
|
Converts a formatted date & time string to a Julian date integer in |
|
Converts a Julian date integer and millisec time to a formatted date & time string |
|
Converts |
|
Converts Julian date integer value and total milliseconds to |
|
Converts a formatted date & time string to a |
|
Converts a |
|
Converts |
|
Converts a |
|
Converts a |
|
Converts total milliseconds to a |
|
Returns an integer indicating the day of the week from a date & time string |
|
Calculate if a specified year is a leap year |
|
Get the day part of a date & time string |
|
Get the month part of a date & time string |
|
Get the year part of a date & time string |
|
Compare two date & time strings to determine if they are: equal in value, one is less than another, or one is greater than another |
|
Returns the difference in days of the first date & time string to the second date & time string |
|
Returns the difference in days or milliseconds of the first date & time string to the second date & time string |
DateTime Functions x64
DTDateFormat
Converts a SYSTEMTIME structure, pointed to by the lpSystermtimeStruct parameter, to a date & time string, into the buffer pointed to by the lpszDateTimeString parameter and returns it formatted as specified by the DateFormat parameter.
DTDateFormat PROTO lpSystermtimeStruct:QWORD, lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpSystermtimeStruct- Pointer to a SYSTEMTIME type that contains date & time information to convert.lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file:; Reverse Date Formats CCYYMMDDHHMMSSMS EQU 1 ; Example 1974/03/27 14:53:01:00 CCYYMMDDHHMMSS EQU 2 ; Example 1974/03/27 14:53:01 CCYYMMDDHHMM EQU 3 ; Example 1974/03/27 14:53 CCYYMMDDHH EQU 4 ; Example 1974/03/27 14:53 CCYYMMDD EQU 5 ; Example 1974/03/27 CCYYMM EQU 6 ; Example 1974/03 YEAR EQU 7 ; Example 1974 ; British Date Formats DDMMCCYYHHMMSSMS EQU 8 ; Example 27/03/1974 14:53:01:00 DDMMCCYYHHMMSS EQU 9 ; Example 27/03/1974 14:53:01 DDMMCCYYHHMM EQU 10 ; Example 27/03/1974 14:53 DDMMCCYY EQU 11 ; Example 27/03/1974 DDMM EQU 12 ; Example 27/03 DAY EQU 13 ; Example 27 ; American Date Formats MMDDCCYYHHMMSSMS EQU 14 ; Example 03/27/1974 14:53:01:00 MMDDCCYYHHMMSS EQU 15 ; Example 03/27/1974 14:53:01 MMDDCCYYHHMM EQU 16 ; Example 03/27/1974 14:53 MMDDCCYY EQU 17 ; Example 03/27/1974 MMDD EQU 18 ; Example 03/27 MONTH EQU 19 ; Example 03 ; Reverse Without Century Date Formats YYMMDDHHMMSSMS EQU 20 ; Example 74/03/27 14:53:01:00 YYMMDDHHMMSS EQU 21 ; Example 74/03/27 14:53:01 YYMMDDHHMM EQU 22 ; Example 74/03/27 14:53 YYMMDD EQU 23 ; Example 74/03/27 YYMM EQU 24 ; Example 74/03 YY EQU 25 ; Example 74 ; Other Date Formats MMDDYY EQU 26 ; Example 03/27/74 DDMMYY EQU 27 ; Example 27/03/74 DAYOFWEEK EQU 28 ; Example Monday ; Time Formats HHMMSSMS EQU 29 ; Example 14:53:01 HHMMSS EQU 30 ; Example 14:53:01 HHMM EQU 31 ; Example 14:53 HH EQU 32 ; Example 14 ; Useful Named Constants TODAY EQU DDMMCCYYHHMMSS NOW EQU DDMMCCYYHHMMSS TIME EQU HHMM ; Named Date Constants AMERICAN EQU MMDDYY BRITISH EQU DDMMYY FRENCH EQU DDMMYY JAPAN EQU YYMMDD TAIWAN EQU YYMMDD MDY EQU MMDDYY DMY EQU DDMMYY YMD EQU YYMMDD
Note
Constants: CC=Century, YY=Year, MM=Month, DD=Day, HH=Hours, MM=Minutes, SS=Seconds, MS=Milliseconds, DOW=Day Of Week
Returns
Returns in RAX TRUE if succesful, or FALSE otherwise.
Notes
The user is responsible for ensuring the buffer pointed to by the lpszDateTimeString parameter is large enought to hold the date & time string value. Recommeneded minimum size for the buffer is 24 bytes long as defined by the DATETIME_STRING constant.
Example
.data
LocalDateTime SYSTEMTIME <>
szDataAndTimeString DB DATETIME_STRING DUP (0)
.code
Invoke GetLocalTime, Addr LocalDateTime
Invoke DTDateFormat, Addr LocalDateTime, Addr szDataAndTimeString, DDMMYY
See Also
DTDateStringsCompare
Compare two date & time strings to determine if they are: equal in value, one is less than another, or one is greater than another.
DTDateStringsCompare PROTO lpszDateTimeString1:QWORD, lpszDateTimeString2:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString1- Pointer to a buffer containing the first date & time string to compare. The format of the date & time string is determined by theDateFormatparameter.lpszDateTimeString2- Pointer to a buffer containing the second date & time string to compare. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to by both thelpszDateTimeString1parameter and thelpszDateTimeString2parameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Return values in RAX indicate the following:
-1First date is less than second date.0First date is equal to second date.+1First date is greater than second date.
Notes
The date & time string pointed to by the lpszDateTimeString1 parameter is compared against the date & time string pointed to by the lpszDateTimeString2 parameter.
Both dates are converted to QWORD values internally before the comparison to see which is greater or less than or equal.
If a date & time string contains time information this will be ignored.
Example
Invoke DTDateStringsCompare, Addr szDateTime1, Addr szDateTime2, CCYYMMDD
See Also
DTDateStringsDifference, DTDateTimeStringsDifference, DateTime Formats
DTDateStringsDifference
Returns the difference in days of the first date & time string to the second date & time string.
DTDateStringsDifference PROTO lpszDateTimeString1:QWORD, lpszDateTimeString2:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString1- Pointer to a buffer containing the first date & time string. The format of the date & time string is determined by theDateFormatparameter.lpszDateTimeString2- Pointer to a buffer containing the second date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to by both thelpszDateTimeString1parameter and thelpszDateTimeString2parameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return RAX contains the difference between the two dates in days as an integer, either positive or negative.
Notes
The date & time string pointed to by the lpszDateTimeString1 parameter is compared against the date & time string pointed to by the lpszDateTimeString2 parameter to determine the difference of the dates.
Both dates are converted to Julian date format internally before comparing the days difference between dates.
If a date & time string contains time information this will be ignored.
Example
.data
CurrentDateTime db DATETIME_STRING dup (0)
SomeOtherDateTime db "2008/03/21",0
.data?
DayDifference dq ?
.code
Invoke DTGetDateTime, Addr CurrentDateTime, CCYYMMDD
Invoke DTDateStringsDifference, Addr CurrentDateTime, Addr SomeOtherDateTime, CCYYMMDD
mov DayDifference, rax ; save day difference to data variable
.IF rax == 0
; No difference in dates, do something...
.ELSE
; Day difference is - or +, do something else...
.ENDIF
See Also
DTDateStringsCompare, DTDateTimeStringsDifference, DateTime Formats
DTDateTimeStringToJulianMillisec
Converts a formatted date & time string to a Julian date integer in RAX and milliseconds in RDX
DTDateTimeStringToJulianMillisec PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to convert to Julian date integer and millisec values. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return RAX contains Julian date integer value representing the date specified and RDX will contain the total time in milliseconds.
Notes
Some information may be unavailable to convert if the passed DateTime string does not contain enough information. For example if only year information is in the DateTime string, then the Julian date and millisec time will be based only on that.
To prevent this, always pass a full date time string of CCYYMMDDHHMMSSMS format or similar (DDMMCCYYHHMMSSMS or MMDDCCYYHHMMSSMS)
The Julian Day Count is a uniform count of days from a remote epoch in the past (-4712 January 1, 12 hours Greenwich Mean Time (Julian proleptic Calendar) = 4713 BCE January 1, 12 hours GMT (Julian proleptic Calendar) At this instant, the Julian Day Number is 0.
The Julian Day Count has nothing to do with the Julian Calendar introduced by Julius Caesar. It is named for Julius Scaliger, the father of Josephus Justus Scaliger, who invented the concept. It can also be thought of as a logical follow-on to the old Egyptian civil calendar, which also used years of constant lengths.
Scaliger chose the particular date in the remote past because it was before recorded history and because in that year, three important cycles coincided with their first year of the cycle: The 19-year Metonic Cycle, the 15-year Indiction Cycle (a Roman Taxation Cycle) and the 28-year Solar Cycle (the length of time for the old Julian Calendar to repeat exactly).
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
JulianDateValue dq ?
TotalMilliseconds dq ?
.code
Invoke DTDateTimeStringToJulianMillisec, Addr DateTimeStringValue
mov JulianDateValue, rax ; save julian date value to data variable
mov TotalMilliseconds, rdx ; save total milliseconds to data variable
Example
.data?
qwDate1 dq ?
qwDate2 dq ?
.code
;==========================================================================================
; Example to calculate difference in 2 date values over month boundary
Invoke DTDateTimeStringToJulianMillisec, CTEXT("27/02/2009"), DDMMCCYY
mov qwDate1, rax ; save dword date portion to variable, ignore edx which contains time info
Invoke DTDateTimeStringToJulianMillisec, CTEXT("03/03/2009"), DDMMCCYY
mov qwDate2, rax ; save dword date portion to variable, ignore edx which contains time info
mov rbx, qwDate1 ; Place date1 in rbx
sub rax, rbx ; subtract date2 from date1, rax = 4 days
;==========================================================================================
; Another example to calculate difference in weeks between 2 date values
Invoke DTDateTimeStringToJulianMillisec, CTEXT("03/01/2009"), DDMMCCYY
mov qwDate1, rax ; save qword date portion to variable, ignore rdx which contains time info
Invoke DTDateTimeStringToJulianMillisec, CTEXT("10/01/2009"), DDMMCCYY
mov qwDate2, rax ; save dword date portion to variable, ignore rdx which contains time info
mov rbx, qwDate1 ; Place date1 in rbx
sub rax, rbx ; subtract date2 from date1, rax = 7 days
xor rdx, rdx ; clear rdx for division
mov rcx, 7d ; Divisor is 7 in rcx
div rcx ; divide eax by 7, rax = 1
See Also
DTDateTimeStringToQwordDateTime
Converts a formatted date & time string to QWORD values. On return RAX contains the date information and RDX the time information.
DTDateTimeStringToQwordDateTime PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to convert toQWORDvalues. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return RAX will contain the date information in the following format:
RAX Register Bits:
+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
On return RDX will contain the time information in the following format:
RDX Register Bits:
+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Notes
The registers always return the information in the format shown in the tables above, and do not change regardless of the DateFormat parameter.
The DateFormat parameter is used to indicate the format of the date & time string being passed to DTDateTimeStringToQwordDateTime.
Some information may be unavailable to convert if the passed DateTime string does not contain enough information. For example if only year information is in the DateTime string, then the DWORD date and DWORD time will be based only on that.
To prevent this, always pass a full date time string of CCYYMMDDHHMMSSMS format or similar (DDMMCCYYHHMMSSMS or MMDDCCYYHHMMSSMS)
To retrieve the various values of the date & time QWORD values you can use the following as an example:
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
DateValue dq ?
TimeValue dq ?
CentYear dq ?
Year dq ?
Month dq ?
Day dq ?
.code
Invoke DTDateTimeStringToQwordDateTime, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov DateValue, rax ; Save date info in rax to a data variable
mov TimeValue, rdx ; Save time info in rdx to a data variable
; save day, month, year and century info to data variables
mov rdx, DateValue ; use rdx as our work place
xor rax, rax ; clear register
mov al, dl ; dl contains day info
mov Day, rax ; save day info DD in dl to a data variable
xor rax, rax ; clear register
mov al, dh ; dh contains month info
mov Month, rax ; save month info MM in dh to a data variable
shr edx, 16 ; century and year are now in dx part of the register
mov CentYear, rdx ; save century and year info CCYY to a data variable
xor rax, rax ; clear register
mov al, dl ; dl contains YY part of year
mov Year, rax ; save year info in dl to a data variable
See Also
DTQwordDateTimeToDateTimeString, DateTime Formats, DTGetDateTime
DTDateTimeStringToUnixTime
Converts a formatted date & time string to a QWORD value containing a unix time integer value.
DTDateTimeStringToUnixTime PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to convert to aQWORDvalue containing a unix time integer value. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return RAX contains the unix time as a QWORD value.
Notes
Some information may be unavailable to convert if the passed DateTime string does not contain enough information. For example if only year information is in the DateTime string, then the UnixTime will be based only on that.
To prevent this, always pass a full date time string of CCYYMMDDHHMMSSMS format or similar (DDMMCCYYHHMMSSMS or MMDDCCYYHHMMSSMS)
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
The UNIXTIMESTAMP format is a string representation of the unix time in integer format if used as the DateFormat value.
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
UnixTime dq ?
.code
Invoke DTDateTimeStringToUnixTime, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov UnixTime, rax ; save unix time value to data variable which should contain 1206116461
Example
.data
UnixTimeAsAStringValue db "1656241202",0 ; Sun Jun 26 2022 11:00
.data?
UnixTime dq ?
.code
Invoke DTDateTimeStringToUnixTime, Addr UnixTimeAsAStringValue, UNIXTIMESTAMP
mov UnixTime, rax ; save unix time value to data variable which should contain 1656241202
See Also
DTUnixTimeToDateTimeString, DTUnixTimeToQwordDateTime, DateTime Formats
DTDateTimeStringsDifference
Returns the difference in days or milliseconds of the first date & time string to the second date & time string.
DTDateTimeStringsDifference PROTO lpszDateTimeString1:QWORD, lpszDateTimeString2:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString1- Pointer to a buffer containing the first date & time string. The format of the date & time string is determined by theDateFormatparameter.lpszDateTimeString2- Pointer to a buffer containing the second date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to by both thelpszDateTimeString1parameter and thelpszDateTimeString2parameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return RAX contains the difference between the two dates in days as an integer, either positive or negative.
On return RDX contains the difference in time or 0, see notes below for details.
Notes
If both dates are the same date, then RAX will be 0. If both date & time strings contain time values and the DateFormat parameter specified also provides a time format, then RDX will contain the difference in time in milliseconds.
Example
.data
CurrentDateTime db DATETIME_STRING dup (0)
SomeOtherDateTime db "2008/03/21",0
.data?
DayDifference dq ?
MillisecDifference dq ?
.code
Invoke DTGetDateTime, Addr CurrentDateTime, CCYYMMDDHHMMSSMS
Invoke DTDateTimeStringsDifference, Addr CurrentDateTime, Addr SomeOtherDateTime, CCYYMMDDHHMMSSMS
mov DayDifference, rax ; save day difference to data variable
mov MillisecDifference, rdx ; save millisec diff if days the same
.IF rax == 0
; No difference in dates
; So MillisecDifference can be used
.ELSE
; Day difference is - or +, do something else...
; MillisecDifference is 0 value
.ENDIF
See Also
DTDateStringsCompare, DTDateStringsDifference, DateTime Formats
DTDay
Get the day part of a date & time string.
DTDay PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to retrieve the day portion from. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns the day value in RAX
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
DayValue dq ?
.code
Invoke DTDay, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov DayValue, rax ; save day part of date value to data variable
; rax should contain 21
See Also
DTMonth, DTYear, DTIsLeapYear, DTDayOfWeek, DateTime Formats
DTDayOfWeek
Returns an integer indicating the day of the week from a date & time string.
DTDayOfWeek PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to check the day of the week for. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
On return RAX will contain a value to indicate the following day:
0= Monday1= Tuesday2= Wednesday3= Thursday4= Friday5= Saturday6= Sunday
Example
; The following example calculates the first day of the week from a date using the DTDayOfWeek function
.data
szDateTime db DATETIME_STRING dup (0)
.data?
qwDate1 dq ?
qwDayWeek dq ?
qwStartWeek dq ?
.code
Invoke DTDateTimeStringToJulianMillisec, CTEXT("04/06/2009"), DDMMCCYY ; Convert date to julian date
mov qwDate1, rax ; only save date info returned in eax, ignore time info returned in edx
Invoke DTDayOfWeek, CTEXT("04/06/2009"), DDMMCCYY ; Get day of week for date
mov qwDayWeek, rax ; Save the returned integer representing day 0-6
mov rbx, rax
mov rax, qwDate1
sub rax, rbx ; subtract julian date value from day of week integer
mov qwStartWeek, rax ; we have new julian date which is start of the week
Invoke DTJulianToDwordDate, qwStartWeek ; convert new julian date start of week number to a date in dword format
Invoke DTDwordDateTimeToDate, rax, NULL, Addr szDateTime, DDMMCCYY ; convert dword date format to a string value
; szDateTime now contains '01/06/2009'
See Also
DTGetDateTime
Get the current date & time and return it as a formatted string as specified by the DateFormat parameter.
DTGetDateTime PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns in RAX TRUE if succesful, or FALSE otherwise.
Notes
The user is responsible for ensuring the buffer pointed to by the lpszDateTimeString parameter is large enought to hold the date & time string value. Recommeneded minimum size for the buffer is 24 bytes long as defined by the DATETIME_STRING constant.
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0) ; buffer to store date and time as string
.code
Invoke DTGetDateTime, Addr DateTimeStringValue, CCYYMMDDHHMMSS
See Also
DTIsLeapYear
Calculate if a specified year is a leap year.
DTIsLeapYear PROTO qwYear:QWORD
Parameters
qwYear- aQWORDvalue that has the year value to check for leap year.
Returns
Returns TRUE if year is a leap year, otherwise FALSE.
Notes
qwYear must include the century. For example 2008 which in a QWORD value is stored as 0x7D8
A year will be a leap year if it is divisible by 4 but not by 100. If a year is divisible by 4 and by 100, it is not a leap year unless it is also divisible by 400.
Example
.data
CurrentDateTimeValue db 32 dup (0) ; buffer to store date & time as string
Year dq 0
.code
Invoke DTGetDateTime, Addr CurrentDateTimeValue, CCYYMMDDHHMMSS
Invoke DTYear, Addr CurrentDateTimeValue, CCYYMMDDHHMMSS
mov Year, rax ; save year
Invoke DTIsLeapYear, rax ; check leap year
.IF rax == TRUE
; Leap year, do something...
.ELSE
; No leap year, do something other...
.ENDIF
See Also
DTJulianDateToQwordDate
Converts a Julian Date number to a QWORD value containing date information. Uses CCYYMMDD DateTime Format
DTJulianDateToQwordDate PROTO JulianDate:QWORD
Parameters
JulianDate- AQWORDvalue containing the Julian date integer to convert to aQWORDformat inRAX
Returns
On return RAX will contain the date information in the following format:
RAX Register Bits:
+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
Notes
The Julian Day Count is a uniform count of days from a remote epoch in the past (-4712 January 1, 12 hours Greenwich Mean Time (Julian proleptic Calendar) = 4713 BCE January 1, 12 hours GMT (Julian proleptic Calendar) At this instant, the Julian Day Number is 0.
The Julian Day Count has nothing to do with the Julian Calendar introduced by Julius Caesar. It is named for Julius Scaliger, the father of Josephus Justus Scaliger, who invented the concept. It can also be thought of as a logical follow-on to the old Egyptian civil calendar, which also used years of constant lengths.
Scaliger chose the particular date in the remote past because it was before recorded history and because in that year, three important cycles coincided with their first year of the cycle: The 19-year Metonic Cycle, the 15-year Indiction Cycle (a Roman Taxation Cycle) and the 28-year Solar Cycle (the length of time for the old Julian Calendar to repeat exactly).
Example
.data
Day db 0
Month db 0
CentYear dw 0
.code
Invoke DTJulianDateToQwordDate, 2299161 ; Gregorian date of this Julian Date value is 1582 October 15
mov rdx, rax
mov Month, ah
mov Day, al
shr rax, 16 ; move year info into lower word of eax
mov CentYear, ax
; 1582 October 15 - CentYear now contains 1582, Month contains 10, Day contains 15
See Also
DTJulianMillisecToDateTimeString
Converts a Julian date integer and millisec time to a formatted date & time string as specified by the DateFormat parameter.
DTJulianMillisecToDateTimeString PROTO JulianDate:QWORD, Milliseconds:QWORD, lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
JulianDate- AQWORDvalue containing the Julian date integer to convert to a gregorian date in the date & time string.Milliseconds- AQWORDvalue containting the total milliseconds to convert to hours, minutes, seconds and milliseconds in the date & time string.lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
There is no return value, the date & time string will contain the date & time as specified by the DateFormat parameter.
Notes
No time information is converted with the Julian date value, so if formatting outputs a time, it will be empty as in 00:00:00:00
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0) ; buffer to store date and time as string
.code
Invoke DTJulianMillisecToDateTimeString, 2299161, 0, Addr DateTimeStringValue, CCYYMMDDHHMMSS
; DateTimeStringValue now contains: 1582/10/15 00:00:00
See Also
DTJulianMillisecToQwordDateTime
Converts Julian date integer value and total milliseconds to QWORD values containing date and time information. On return RAX contains the date information and RDX the time information.
DTJulianMillisecToQwordDateTime PROTO JulianDate:QWORD, Milliseconds:QWORD
Parameters
JulianDate- AQWORDvalue containing the Julian date integer to convert to aQWORDdate inRAX.Milliseconds- AQWORDvalue containting the total milliseconds to convert to hours, minutes, seconds and milliseconds inQWORDtime inRDX.
Returns
On return RAX will contain the date information in the following format:
RAX Register Bits:
+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
On return RDX will contain the time information in the following format:
RDX Register Bits:
+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Notes
The registers always return the information in the format shown in the tables above.
Example
.data?
qwDate dq ?
qwTime dq ?
Year dw ?
Month db ?
Day db ?
Hours db ?
Minutes db ?
Seconds db ?
Millisec db ?
.code
Invoke DTJulianMillisecToDwordDateTime, 2299161, 0
mov qwDate, rax ; rax contains the date information
mov qwTime, rdx ; rdx contains the time information
mov rax, qwDate
shr rax, 16 ; move year into upper word of eax
mov Year, ax ; year
mov rax, qwDate
mov Month, ah ; month
mov Day, al ; day
mov rax, qwTime
shr rax, 16 ; move hour and minute into upper word of eax
mov Hours, ah ; hours
mov Minutes, al ; minutes
mov rax, qwTime
mov Seconds, ah ; seconds
mov Millisec, al ; millseconds
See Also
DTQwordDateTimeToJulianMillisec, DTQwordDateToJulianDate, DTQwordTimeToMillisec
DTMillisecToQwordTime
Converts total milliseconds to a QWORD value containing time information in hours, minutes, seconds and milliseconds.
DTMillisecToQwordTime PROTO Milliseconds:QWORD
Parameters
Milliseconds- AQWORDvalue containting the total milliseconds to convert to hours, minutes, seconds and milliseconds inQWORDtime inRAX.
Returns
On return RAX will contain the time information in the following format:
RAX Register Bits:
+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Notes
Example
Invoke DTMillisecToQwordTime, qwMilliseconds
See Also
DTQwordTimeToMillisec, DTQwordDateToJulianDate, DTQwordDateTimeToJulianMillisec, DTJulianMillisecToQwordDateTime
DTMonth
Get the month part of a date & time string.
DTMonth PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to retrieve the month portion from. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns the month value in RAX
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
MonthValue dq ?
.code
Invoke DTMonth, Addr DateTimeStringValue, CCYYMMDDHHMMSSMS
mov MonthValue, rax ; save month part of date value to data variable
; rax should contain 3
Example
.data?
qwMonth1 dq ?
qwMonth2 dq ?
.code
Invoke DTMonth, CTEXT("27/02/2009"), DDMMCCYY
mov qwMonth1, rax ; save month to variable
Invoke DTMonth, CTEXT("03/03/2009"), DDMMCCYY
mov qwMonth2, rax ; save month to variable
mov rbx, qwMonth1 ; place month1 variable in rbx
sub rax, rbx ; subtract month2 from month1, rax = 1 in this example
See Also
DTQwordDateTimeToDateTimeString
Converts QWORD values containing date & time information to a formatted date & time string as specified by the DateFormat parameter.
DTQwordDateTimeToDateTimeString PROTO qwDate:QWORD, qwTime:QWORD, lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
qwDate-QWORDvalue containing Date information to convert to the date & time string
The format for the value containing the date information is as follows:
date
QWORDRegister Bits:+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
qwTime-QWORDvalue containing Time information to convert to the date & time string
The format for the value containing the time information is as follows:
time
QWORDRegister Bits:+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
No return value
Notes
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0) ; buffer to store date and time as string
DateValue dq 0
TimeValue dq 0
.code
xor rax, rax
mov rax, 1974 ; save year
shl rax, 16 ; move it into upper word of rax
mov ah, 03 ; save month
mov al, 15 ; save day
mov DateValue, rax
xor rax, rax
mov ah, 12 ; save hours
mov al, 34 ; save minutes
shl rax, 16 ; move it into upper word of rax
mov ah, 01 ; save seconds
mov al, 0 ; save milliseconds
mov TimeValue, rax
Invoke DTQwordDateTimeToDateTimeString, DateValue, TimeValue, Addr DateTimeStringValue, CCYYMMDDHHMMSS
; DateTimeStringValue will now contain "1974/03/15 12:36:01"
See Also
DTDateTimeStringToQwordDateTime, DateTime Formats, DTGetDateTime
DTQwordDateTimeToJulianMillisec
Converts QWORD values containing date & time information to Julian date and total milliseconds.
DTQwordDateTimeToJulianMillisec PROTO qwDate:QWORD, qwTime:QWORD
Parameters
qwDate-QWORDvalue containing date information to convert to Julian date.
The format for the value containing the date information is as follows:
date
QWORDRegister Bits:+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
qwTime-QWORDvalue containing time information to convert to the total milliseconds.
The format for the value containing the time information is as follows:
time
QWORDRegister Bits:+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Returns
On return RAX will contain the Julian date integer, and RDX the total millliseconds.
Notes
Example
Invoke DTQwordDateTimeToJulianMillisec, qwDate, qwTime
See Also
DTJulianMillisecToQwordDateTime, DTJulianDateToQwordDate, DTMillisecToQwordTime
DTQwordDateTimeToUnixTime
Converts QWORD values containing date & time information to a QWORD value containing a unix time integer value. On return RAX contains the unix time integer value.
DTQwordDateTimeToUnixTime PROTO qwDate:QWORD, qwTime:QWORD
Parameters
qwDate-QWORDvalue containing date information to convert to a unix time integer value.
The format for the value containing the date information is as follows:
date
QWORDRegister Bits:+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
qwTime-QWORDvalue containing time information to convert to a unix time integer value.
The format for the value containing the time information is as follows:
time
QWORDRegister Bits:+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Returns
On return RAX will contain the unix time integer value.
Notes
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
Example
Invoke DTQwordDateTimeToUnixTime, qwDate, qwTime
See Also
DTUnixTimeToQwordDateTime, DTDateTimeStringToUnixTime, DTUnixTimeToDateTimeString
DTQwordDateToJulianDate
Converts a QWORD value containing date information to a Julian date integer. On return RAX contains the date information in Julian Date format.
DTQwordDateToJulianDate PROTO qwDate:QWORD
Parameters
qwDate-QWORDvalue containing Date information to convert to a Julian date integer.
The format for the value containing the date information is as follows:
date
QWORDRegister Bits:+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
Returns
On return RAX contains Julian date integer value representing the date specified.
Notes
The Julian Day Count is a uniform count of days from a remote epoch in the past (-4712 January 1, 12 hours Greenwich Mean Time (Julian proleptic Calendar) = 4713 BCE January 1, 12 hours GMT (Julian proleptic Calendar) At this instant, the Julian Day Number is 0.
The Julian Day Count has nothing to do with the Julian Calendar introduced by Julius Caesar. It is named for Julius Scaliger, the father of Josephus Justus Scaliger, who invented the concept. It can also be thought of as a logical follow-on to the old Egyptian civil calendar, which also used years of constant lengths.
Scaliger chose the particular date in the remote past because it was before recorded history and because in that year, three important cycles coincided with their first year of the cycle: The 19-year Metonic Cycle, the 15-year Indiction Cycle (a Roman Taxation Cycle) and the 28-year Solar Cycle (the length of time for the old Julian Calendar to repeat exactly).
Example
.data
Day db 15
Month db 10
CentYear dw 1582
DateValue dq 0
.code
xor rax, rax
mov ax, CentYear
shl rax, 16 ; move year into upper word of rax
mov ah, Month ; move month into ah
mov al, Day ; move day into al
mov DateValue, rax
Invoke DTQwordDateToJulianDate, DateValue
; EAX now contains 2299161 which is the Julian Date for 1582 October 15
See Also
DTJulianDateToQwordDate, DTMillisecToQwordTime, DTQwordDateTimeToJulianMillisec, DTJulianMillisecToQwordDateTime
DTQwordTimeToMillisec
Converts a QWORD value containing time information to total amount of milliseconds.
DTQwordTimeToMillisec PROTO dwTime:QWORD
Parameters
qwTime-QWORDvalue containing time information to convert to total amount of milliseconds.
The format for the value containing the time information is as follows:
time
QWORDRegister Bits:+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Returns
On return RAX will contain the total milliseconds.
Notes
Example
Invoke DTQwordTimeToMillisec, qwTime
See Also
DTMillisecToQwordTime, DTJulianDateToQwordDate, DTQwordDateTimeToJulianMillisec, DTJulianMillisecToQwordDateTime
DTUnixTimeToDateTimeString
Converts a QWORD containing a unix time integer value to a formatted date & time string as specified by the DateFormat parameter.
DTUnixTimeToDateTimeString PROTO UnixTime:QWORD, lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
UnixTime-QWORDcontaining a unix time integer value to convert to a date & time string.lpszDateTimeString- Pointer to a buffer to store the date & time string. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format to return in the buffer pointed to bylpszDateTimeStringparameter. The parameter can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
There is no return value, the date & time string will contain the date & time as specified by the DateFormat specified.
Notes
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
The UNIXTIMESTAMP format is a string representation of the unix time in integer format if used as the DateFormat value.
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0)
.code
Invoke DTUnixTimeToDateTimeString, 1276278420, Addr szDateTimeString, DDMMCCYYHHMMSSMS
; DateTimeString should now contain the string "11/06/2010 17:47:00:00"
Example
.data
DateTimeStringValue db DATETIME_STRING dup (0)
.code
Invoke DTUnixTimeToDateTimeString, 1656241202, Addr szDateTimeString, UNIXTIMESTAMP
; DateTimeString should now contain the string "1656241202"
See Also
DTDateTimeStringToUnixTime, DTQwordDateTimeToUnixTime, DateTime Formats
DTUnixTimeToQwordDateTime
Converts a QWORD containing a unix time integer value to QWORD values containing date and time information.
DTUnixTimeToQwordDateTime PROTO UnixTime:QWORD
Parameters
UnixTime-QWORDcontaining a unix time integer value to convert toQWORDdate & time values.
Returns
On return RAX will contain the date information in the following format:
RAX Register Bits:
+--------------------------------------------------+------------------------+------------+-----------+ | DWORD | WORD | BYTE | BYTE | +--------------------------------------------------+------------------------+------------+-----------+ | Bits 63-32 | Bits 31-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------------------+------------+-----------+ | Not used - Not applicable | Century Year | Month | Day | +--------------------------------------------------+------------------------+------------+-----------+ | N/A | CCCCYY | MM | DD | +--------------------------------------------------+------------------------+------------+-----------+
On return RDX will contain the time information in the following format:
RDX Register Bits:
+--------------------------------------------------+------------+------------+-----------+-----------+ | DWORD | BYTE | BYTE | BYTE | BYTE | +--------------------------------------------------+------------+------------+-----------+-----------+ | Bits 63-32 | Bits 31-23 | Bits 23-16 | Bits 15-8 | Bits 7-0 | +--------------------------------------------------+------------+------------+-----------+-----------+ | Not used - Not applicable | Hour | Minute | Second | Millisec | +--------------------------------------------------+------------+------------+-----------+-----------+ | N/A | HH | MM | SS | MS | +--------------------------------------------------+------------+------------+-----------+-----------+
Notes
Unix time is defined as the number of seconds elapsed since 00:00 Universal time on January 1, 1970 in the Gregorian calendar (Julian day 2440587.5)
Example
.data?
qwDate dq ?
qwTime dq ?
Year dw ?
Month db ?
Day db ?
Hours db ?
Minutes db ?
Seconds db ?
Millisec db ?
.code
Invoke DTUnixTimeToQwordDateTime, 1276278420
mov qwDate, rax ; rax contains the date information
mov qwTime, rdx ; rdx contains the time information
mov rax, qwDate
shr rax, 16 ; move year into upper word of rax
mov Year, ax ; year
mov rax, qwDate
mov Month, ah ; month
mov Day, al ; day
mov rax, qwTime
shr eax, 16 ; move hour and minute into upper word of eax
mov Hours, ah ; hours
mov Minutes, al ; minutes
mov rax, qwTime
mov Seconds, ah ; seconds
mov Millisec, al ; millseconds
See Also
DTQwordDateTimeToUnixTime, DTDateTimeStringToUnixTime, DTUnixTimeToDateTimeString
DTYear
Get the year part of a date & time string.
DTYear PROTO lpszDateTimeString:QWORD, DateFormat:QWORD
Parameters
lpszDateTimeString- Pointer to a buffer containing the date & time string to retrieve the year portion from. The format of the date & time string is determined by theDateFormatparameter.DateFormat- Value indicating the date & time format used in the buffer pointed to bylpszDateTimeStringparameter. The paramater can contain one of the following constants as listed in the DateTime Formats page and as defined in theDateTime.incinclude file.
Returns
Returns the year value in RAX
Example
.data
DateTimeStringValue db "2008/03/21 16:21:01:00",0
.data?
YearValue dq ?
.code
Invoke DTYear, Addr DateTimeStringValue
mov YearValue Value, rax ; save year part of date value to data variable
; eax should contain 2008
See Also
Function |
Description |
Get the current date & time and return it as a formatted string |
|
Converts a |
|
Converts |
|
Converts a formatted date & time string to |
|
Converts a |
|
Converts a Julian Date number to a |
|
Converts a formatted date & time string to a Julian date integer in |
|
Converts a Julian date integer and millisec time to a formatted date & time string |
|
Converts |
|
Converts Julian date integer value and total milliseconds to |
|
Converts a formatted date & time string to a |
|
Converts a |
|
Converts |
|
Converts a |
|
Converts a |
|
Converts total milliseconds to a |
|
Returns an integer indicating the day of the week from a date & time string |
|
Calculate if a specified year is a leap year |
|
Get the day part of a date & time string |
|
Get the month part of a date & time string |
|
Get the year part of a date & time string |
|
Compare two date & time strings to determine if they are: equal in value, one is less than another, or one is greater than another |
|
Returns the difference in days of the first date & time string to the second date & time string |
|
Returns the difference in days or milliseconds of the first date & time string to the second date & time string |
DateTime Formats
Some of the functions used in the library allow for a specified date & time format as either required by a function or in some cases as desired as an output.
The following are constants defined in the DateTime.inc include file.
DateTime Constant |
Example of DateTime String |
CCYYMMDDHHMMSSMS |
1974/03/27 14:53:01:00 |
CCYYMMDDHHMMSS |
1974/03/27 14:53:01 |
CCYYMMDDHHMM |
1974/03/27 14:53 |
CCYYMMDD |
1974/03/27 |
CCYYMM |
1974/03 |
YEAR |
1974 |
DDMMCCYYHHMMSSMS |
27/03/1974 14:53:01:00 |
DDMMCCYYHHMMSS |
27/03/1974 14:53:01 |
DDMMCCYYHHMM |
27/03/1974 14:53 |
DDMMCCYY |
27/03/1974 |
DDMM |
27/03 |
DAY |
27 |
MMDDCCYYHHMMSSMS |
03/27/1974 14:53:01:00 |
MMDDCCYYHHMMSS |
03/27/1974 14:53:01 |
MMDDCCYYHHMM |
03/27/1974 14:53 |
MMDDCCYY |
03/27/1974 |
MMDD |
03/27 |
MONTH |
03 |
YYMMDDHHMMSSMS |
74/03/27 14:53:01:00 |
YYMMDDHHMMSS |
74/03/27 14:53:01 |
YYMMDDHHMM |
74/03/27 14:53 |
YYMMDD |
74/03/27 |
YYMM |
74/03 |
YY |
74 |
MMDDYY |
03/27/74 |
DDMMYY |
27/03/74 |
DAYOFWEEK |
Monday |
HHMMSSMS |
14:53:01 |
HHMMSS |
14:53:01 |
HHMM |
14:53 |
HH |
14 |
UNIXTIMESTAMP |
1276278420 |
TODAY |
same as DDMMCCYYHHMMSS |
NOW |
same as DDMMCCYYHHMMSS |
TIME |
same as HHMM |
AMERICAN |
same as MMDDYY |
BRITISH |
same as DDMMYY |
FRENCH |
same as DDMMYY |
JAPAN |
same as YYMMDD |
TAIWAN |
same as YYMMDD |
MDY |
same as MMDDYY |
DMY |
same as DDMMYY |
YMD |
same as YYMMDD |
Note
Constants: CC=Century, YY=Year, MM=Month, DD=Day, HH=Hours, MM=Minutes, SS=Seconds, MS=Milliseconds, DOW=Day Of Week
Note
The UNIXTIMESTAMP format is a string representation of the unix time in integer format and used in the DTDateTimeStringToUnixTime and DTUnixTimeToDateTimeString functions.