Added script support for wxDateTime values:

- added ScriptDateTime type
 - added to_date function
 - added date formating support to to_string.
 - documented all of the above.

git-svn-id: svn://svn.code.sf.net/p/magicseteditor/code/trunk@1348 0fc631ac-6414-0410-93d0-97cfa31319b6

doc/function/index.txt

@@ -9,6 +9,7 @@ These functions are built into the program, other [[type:function]]s can be defi
 | [[fun:to_number]]		Convert any value to a number
 | [[fun:to_boolean]]		Convert any value to a [[type:boolean]]
 | [[fun:to_color]]		Convert any value to a [[type:color]]
+| [[fun:to_date]]		Convert any value to a [[type:date]]
 	
 ! Numbers			<<<
 | [[fun:abs]]			Absolute value

doc/function/to_date.txt

@@ -0,0 +1,19 @@
+Function: to_date
+
+DOC_MSE_VERSION: since 0.3.8
+
+--Usage--
+> to_date(any value)
+
+Convert a string value to a [[type:date]].
+
+--Parameters--
+! Parameter	Type			Description
+| @input@	[[type:string]]		Value to convert to a date.
+
+--Examples--
+> to_date("2008-12-31 23:59:59")
+> to_date("today midnight")
+
+--See also--
+| [[fun:to_string]]	Convert dates to strings

doc/function/to_string.txt

@@ -15,12 +15,13 @@ The former converts things like number to string, while the latter removes tags
 ! Parameter	Type			Description
 | @input@	''any type''		Value to convert to a string
 | @format@	''optional''		Formatting to apply.<br/>
-		 			This takes the same form as [[http://www.cplusplus.com/reference/clibrary/cstdio/printf.html|printf format specifiers]].
+		 			This takes the same form as [[http://www.cplusplus.com/reference/clibrary/cstdio/printf.html|printf format specifiers]].<br/>
+		 			When formating a date, the format string takes the same form as [[http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html|strftime format specifiers]].
 
 --Examples--
 > to_string(to_color("blue"))       == "rgb(0,0,255)"
 > to_string(10 + 20)                == "30"
 > to_string(10 + 20, format: ".3f") == "30.000"
 > to_string(10 + 20, format: "x")   == "1e" # hexadecimal notation
-> to_string("xy", format: "3s")    == " xy"
-
+> to_string("xy", format: "3s")     == " xy"
+> to_string(to_date("2008-12-31 23:59:59"), format:"%d/%m/%y") == "31/12/08"

doc/type/date.txt

@@ -0,0 +1,13 @@
+Primitive type: date and time
+
+DOC_MSE_VERSION: since 0.3.8
+
+A point in time, consisting of a date and a time.
+The file syntax uses [[http://en.wikipedia.org/wiki/ISO_8601|ISO 8601]] notation.
+
+--File syntax--
+> something: 2008-12-31 23:59:59
+
+--See also--
+| [[fun:to_date]]	Convert a value to a date
+| [[fun:to_string]]	Convert dates to strings

doc/type/index.txt

@@ -66,3 +66,4 @@ These contain several properties, similair to the file types. But they are part
 | [[type:double]]		Real numbers, @1, 0.5, 21.3@
 | [[type:version]]		Version numbers
 | [[type:color]]		Colors
+| [[type:date]]			Dates/times