Date & Time Plugin Readme

 ===========================================
|Date & Time Plugin v.1.0 for RPG Maker 2003|
|For DynRPG version 0.13 or higher          |
|By elvissteinjr                            |
 ===========================================

[SCROLL DOWN FOR ENGLISH INSTRUCTIONS!]

Deutsch
-------

Das Date & Time Plugin ermöglicht Zugriff auf Datum und Uhrzeit des PCs.
Es ist auch möglich mit Hilfe von Timestamps ein Datum zu berechnen.
Alle Daten sind abhängig von den Einstellungen des PCs.

Ein Beispielprojekt ist im "demo" Ordner zu finden.
Den Quellcode kann man im "src" Ordner finden. Es handelt sich dabei um ein Code::Blocks Projekt.

Installation
------------

1) Stellt sicher dass der DynRPG-Patch bei eurem Spiel installiert ist: http://cherrytree.at/dynrpg
2) Kopiert die date_and_time.dll in den DynPlugins-Ordner eures Spiels.

Kommentarbefehle
----------------

Es gibt 16 Kommentarbefehle um Datum und Uhrzeit abzufragen oder umzuwandeln (benutzt sie in Event-Kommentaren):
(HINWEIS: Ihr könnt auch das Prefix "V" für Parameter benutzen deren Wert aus einer Variable gelesen werden soll. Ihr könnt auch mehr als ein "V"-Präfix verwenden.)

 @GetTimestamp VariableID
 ------------------------
 Schreibt den aktuellen Timestamp in die Variable mit der angegebenden ID.

 @GetDate VariableID(Monat), VariableID(Tag), VariableID(Jahr)
 -------------------------------------------------------------
 Schreibt das aktuelle Datum in die Variablen mit den angegebenen IDs.

 @GetMonth VariableID
 ---------------------------
 Schreibt den aktuellen Monat in die Variable mit der angegebenen ID.

 @GetDay VariableID
 ------------------
 Schreibt den aktuellen Tag in die Variable mit der angegebenen ID.

 @GetYear VariableID
 -------------------
 Schreibt das aktuelle Jahr in die Variable mit der angegebenen ID.

 @GetWeekday VariableID
 ----------------------
 Schreibt den aktuellen Wochentag in die Variable mit der angegebenen ID.
 Der Wert fängt mit 0 an und endet mit 6. Erster Tag ist Sonntag.

 @GetYearday VariableID
 ----------------------
 Schreibt den aktuellen Tag im Jahr in die Variable mit der angegebenen ID.

 @GetTime VariableID(Stunde), VariableID(Minute), VariableID(Sekunde)
 --------------------------------------------------------------------
 Schreibt die aktuelle Zeit in die Variablen mit den angegebenen IDs.

 @GetHour VariableID
 -------------------
 Schreibt die aktuelle Stunde in die Variable mit der angebenen ID.

 @GetMinute VariableID
 ---------------------
 Schreibt die aktuelle Minute in die Variable mit der angegbenen ID.

 @GetSecond VariableID
 ---------------------
 Schreibt die akutelle Sekunde in die Variable mit der angegebenen ID.

 @GetDateFromTimestamp Timestamp, VariableID(Monat), VariableID(Tag), VariableID(Jahr)
 -------------------------------------------------------------------------------------
 Schreibt das Datum des angegebenen Timestamps in die Variablen mit den angegebenen IDs.

 @GetTimeFromTimestamp Timestamp VariableID(Stunde), VariableID(Minute), VariableID(Sekunde)
 -------------------------------------------------------------------------------------------
 Schreibt die Zeit des angegebenen Timestamps in die Variablen mit der angebenen IDs.

 @GetWeekdayFromTimestamp Timestamp, VariableID
 ----------------------------------------------
 Schreibt den Wochentag des angegebenen Timestamps in die Variable mit der angegebenen ID.

 @GetYeardayFromTimestamp Timestamp, VariableID
 ----------------------------------------------
 Schreibt den Tag des Jahres des angegebenen Timestamps in die Variable mit der angegebenen ID.

 @GetTimestampFromDate Monat, Tag, Jahr, VariableID(Timestamp)
 -------------------------------------------------------------
 Schreibt den Timestamp des angegebenen Datums in die Variable mit der angegebenen ID.

 @GetTimestampFromDate Monat, Tag, Jahr, Stunde, Minute, Sekunde, VariableID(Timestamp)
 --------------------------------------------------------------------------------------
 Überladene Version von GetTimestampFromDate mit Angabe der Zeit.


Hinweise
--------

-Ein Timestamp ist der Zeitabstand zum 1. Januar 1970 00:00 Uhr UTC in Sekunden.
-Das Plugin hebt das Limit des Change Variable Eventbefehls auf, damit man mit Timestamps rechnen kann.
 Während Addition und Substraktion problemlos möglich ist, ist Multiplikation oder Division mit übergroßen
 Zahlen nicht empfohlen.


Falls du auf irgendwelche Problem stoßen solltest, oder Fragen hast, schreibe mir einfach eine Email:
admin@elvissteinjr.de



English
-------

The Date & Time plugin grants access to the date and time of the PC.
It's also possible to calculate a date with timestamps.
All data is dependent of the settings of the PC.
In the 'demo' folder you can find a demo game.
In the 'src' folder you can find the source code of this plugin. It's a Code::Blocks project.

Installation
------------

1) Make sure the DynRPG patch is installed at your game: http://cherrytree.at/dynrpg
2) Copy date_and_time.dll into your game's DynPlugins folder.

Comment Commands
----------------

There are 15 comment commands which can be used to get date and time or convert it (use them in event comments):
(NOTE: You may use the prefix "V" for parameters to have the value of the parameter read from a variable. You can also use more than one "V" prefix.)

 @GetTimestamp VariableID
 ------------------------
 Writes the current timestamp into the variable with the given ID.

 @GetDate VariableID(Month), VariableID(Day), VariableID(Year)
 -------------------------------------------------------------
 Writes the current date into the variables with the given IDs.

 @GetMonth VariableID
 ---------------------------
 Writes the current month into the variable with the given ID.

 @GetDay VariableID
 ------------------
 Writes the current day into the variable with the given ID.

 @GetYear VariableID
 -------------------
 Write the current year into the variable with the given ID.

 @GetWeekday VariableID
 ----------------------
 Write the current weekday into the variable with the given ID.
 The value starts with 0 and ends with 6. First day is Sunday.

 @GetYearday VariableID
 ----------------------
 Writes the current day of the year into the variable with the given ID.

 @GetTime VariableID(Hour), VariableID(Minute), VariableID(Second)
 --------------------------------------------------------------------
 Writes the current time into the variables with the given IDs.

 @GetHour VariableID
 -------------------
 Writes the current hour into the variable with the given ID.

 @GetMinute VariableID
 ---------------------
 Writes the current minute into the variable with the given ID.

 @GetSecond VariableID
 ---------------------
 Writes the current second into the variable with the given ID.

 @GetDateFromTimestamp Timestamp, VariableID(Month), VariableID(Day), VariableID(Year)
 -------------------------------------------------------------------------------------
 Writes the date of the given timestamp into the variables with the given IDs.

 @GetTimeFromTimestamp Timestamp, VariableID(Hour), VariableID(Minute), VariableID(Second)
 -----------------------------------------------------------------------------------------
 Writes the date if the given timestamp into the variables with the given IDs.

 @GetWeekdayFromTimestamp Timestamp, VariableID
 ----------------------------------------------
 Writes the weekday of the given timestamp into the variable with the given ID.

 @GetYeardayFromTimestamp Timestamp, VariableID
 ----------------------------------------------
 Writes the day of the year of the given timestamp into the variable with the given ID.

 @GetTimestampFromDate Month, Day, Year, VariableID(Timestamp)
 -------------------------------------------------------------
 Writes the timestamp of the given date into the variable with the given ID.

 @GetTimestampFromDate Month, Day, Year, Hour, Minute, Second, VariableID(Timestamp)
 -----------------------------------------------------------------------------------
 Overloaded version of GetTimestampFromDate with time.


Notes
-----

-A timestamp is defined as the number of seconds elapsed since 00:00 UTC of January 1, 1970.
-The plugin removes the the limit of the Change Variable event command to be able to calculate timestamps.
 While addition and substraction are no problems, multiplication and division of oversized numbers aren't
 recommended.


If you encounter any problems, or have any questions, write an email to me:
admin@elvissteinjr.de