qtDateTime - Getting Started

qtDateTime consists of a library (.lib) and a Fortran 95 MODULE (.mod) containing methods and procedures for handling date and time. It provides the modern Fortran programmer with date and time TYPEs with which he can operate similarily as with elemental Fortran types. This is achieved within the qtDateTime MODULE in which some elemental Fortran operators are overloaded, such as arithmetic operators  + , -  the assignment operator  =  and relational expression operators  <  <=  ==  /=  >  >= . And, there are also a few other basic helpful functions when operating with dates and time. See the overview in online-help for details.

Online-Help / Documentation

qtDateTime's procedures are programmed in a Fortran 95 MODULE, and the documentation is created inline (by comments) according to syntax specifications of a documentation tool named doxygen. doxygen can generate diverse online-help file formats. Here HTML is used. And thus the qtDateTime online-help can be viewed in an Internet browser.

doxygen interprets Fortran source code procedures CONTAINed in a MODULE as "data types", because it is treating Fortran MODULEs similar to what generally is called a "class". And so, FUNCTIONs and SUBROUTINEs CONTAINed in a MODULE are seen as members of a class. So, at the beginning the online-help may be a bit confusing and you have to click through the navigation bar (left part of the documentation area) a bit until you find what you are looking for. To make it a bit easier a link is set here:

Start qtDateTime's online-help

Bindings & Example Programs

To use qtDateTime easily with your Fortran compiler system the following is provided:

• bindings consisting of the qtDateTime library (.lib) and .mod files (you will find them in subdirectories designated to the compilers being supported; for example "Bindings\IVF\Win32")
• a sample program in Fortran 95 source code (Ex01DateTime.f90) that demonstrate the usage of qtDateTime procedures and methods
• sample projects that show the compiler and linker settings to build executables (.exe) from the sample programs
• a dummy licence file named qtSetLicence_qtDateTime.f90 which is to be replaced by a licence file (named similar to qtSetLicence_7496_123456.f90) that you will receive on purchase of qtDateTime

Using qtDateTime with Intel Visual Fortran (IVF)

In the subdirectory "Examples\IVF" of your qtDateTime installation you will find a Microsoft Visual Studio 2008 solution file named IVF.sln. Load this in Visual Studio 2008 or higher. When you use a or more recent version of Visual Studio (for example 2010) the projects contained in IVF.sln should be converted automatically.
Then select a platform (either "Win32" or "x64") and a configuration (either "Debug" or "Release"), and run "Build" to create the executables.
Inspect the settings of the compiler and the linker to see what is changed from the default settings such that the .mod files and the library file (.lib) are found. In particular have a look at:
Fortran | Preprocessor: Additional Include Directories = ..\..\..\Bindings\IVF\$(PlatformName)
Linker | General: Additional Library Directories = ..\..\..\Bindings\IVF\$(PlatformName)
The libraries have been added to the project. Depending on the selected platform either the 32-bit or 64-bit variants are excluded from the "Build".
When having received a licence file (e.g.: qtSetLicence_7496_123456.f90) add this file to the sample projects and remove the dummy licence file named qtSetLicence_qtDateTime.f90. Change the sample source code such that your licence is being used. For example:

!xxx iRet = qtDateTime_Initialize('evaluation')
iRet = qtDateTime_Initialize('L7496-123456')

Run "Build" to obtain an .exe that does not run in demo mode.

Using qtDateTime with Silverfrost FTN95 (FTN95)

In the subdirectory "Examples\FTN95" of your qtDateTime installation you will find a Plato project file (.ftn95p). Load this in the Plato IDE. Then select a configuration (for examle "Debug Win32"), and run "Build" to create the executable.
Inspect the settings of the compiler and the linker to see what is changed from the default settings such that the .mod files are found. In particular have a look at:
Compiler Options | Source: Specify Module paths = ..\..\..\Bindings\FTN95
To link the library file qtDateTimeFTN95.lib, you should notice that it is listed in "References".

When having received a licence file (e.g.: qtSetLicence_7496_123456.f90) add this file to the sample projects and remove the dummy licence file named qtSetLicence_qtDateTime.f90. Change the sample source code such that your licence is being used. For example:

!xxx iRet = qtDateTime_Initialize('evaluation')
iRet = qtDateTime_Initialize('7496-123456')

Run "Build" to obtain an .exe that does not run in demo mode.

Licence Agreement - Usage Rights, Limitation of Liability, Copyright

§1 Property and Ownership
The software described in this document and this document itself is called qtDateTime in the following. The qtDateTime software consists of files whose names start with the letters "qt" as they are found in the subdirectories of the qtDateTime installation. In particular these are library files ending on .lib, pre-compiled MODULE files (ending on .mod), Fortran source code files (ending on .f90). All these files are property of the author Jörg Kuthe. The author is represented by QT software GmbH, called QT hereafter, which is authorized to allocate use rights to qtDateTime. The copyright at the qtDateTime software and this documentation remains with the author.

§2 Licensee
The licensee is the user of the qtDateTime software, which he/she has obtained from QT in the course of the purchase of the qtDateTime licence.

§3 Licence and Passing on of Components of the qtDateTime Software
The licence consists of the right of the licensee to use the qtDateTime software for the development of programs, i.e. thus to create executable files whose name ends on .exe. The executable file created with qtDateTime may neither have the function of a compiler nor that one of a linker. The passing on of any other file of qtDateTime is not allowed.

§4 Transfer and Assignment of the Licence
The licensee cannot be represented by another person. This excludes particularly the rental of the qtDateTime software. The licensee may sell the use licence if he reports the disposal or assignment of the licence to another licensee to QT in writing. The assignment must include the confirmation, that the selling licensee gives up his rights at the qtDateTime. The new licensee must agree to these licence conditions in writing.

§5 Warranty
QT ensures the function ability of the qtDateTime software for the period of 2 years after acquisition of the licence. In the fault case it is up to QT either to refund the paid price to the licensee or to fix the reported error in the qtDateTime software. If the money paid for qtDateTime is refunded, the licensee looses the right to use the software qtDateTime. Complaints or faults have to be verified by the licensee by a program he provides.

§6 Use Risk and Limitations of Liability
The licensee uses the software qtDateTime on risk of his own. QT is liable in maximum amount of the paid price for a single qtDateTime licence.

§7 Declaration of Consent
The licensee gives his agreement to these conditions by the acquisition of the licence.

Other Notes

The author and QT software GmbH acknowledge the rights of the owners at the brand names, trademarks and products named in this document:
Windows is a trademark of Microsoft Corporation, U.S.A.
“ProFortran for Windows” is a product of Absoft Corporation, U.S.A..
“Intel Visual Fortran” is a product of Intel Corporation, U.S.A..
“Lahey/Fujitsu Fortran 95 for Windows” is a product of Lahey Computer Systems, Inc., U.S.A..
“Salford FTN95” is a product of Salford Software Ltd., U.K..
“Silverfrost FTN95” is a product of Salford Software Ltd., U.K..
“Visual Studio 2008”, “Visual Studio 2010”, “Visual Studio 2012”, “Visual Studio 2013”,are products of Microsoft Corporation, U.S.A.

(C) Copyright QT software GmbH, Germany. All rights reserved. 2020