What is the (system)Date? Year, Month, Day, and Second.
One thing about Director is that the help files are often missing things. One key thing is time (I heard it keeps on ticking). Think about all these different things (roughly grouped) – feel free to start typing in the message window.
the ticks
_movie.ticks()
the milliseconds
_system.milliseconds
the date
the long date
_movie.date()
_system.date()
the time
the long time
_movie.time()
_system.time()
the systemDate
_movie.systemDate()
_movie.systemDate().year
_movie.systemDate().month
_movie.systemDate().day
_movie.systemDate().seconds
What are all these things? Well…some are old, some are new, some are undocumented, and some are blue (ok…maybe not). Running a little script to show each of those items you get the following:
— “2861209 = the ticks”
— “2861210 = _movie.ticks()”
— “47686843 = the milliseconds”
— “47686848 = _system.milliseconds”
— “3/2/08 = the date”
— “Sunday, March 2, 2008 = the long date”
— “3/2/08 = _movie.date()”
— “3/2/08 = _system.date()”
— “8:14 PM = the time”
— “8:14:21 PM = the long time”
— “8:14 PM = _movie.time()”
— “8:14 PM = _system.time()”
— “date( 2008, 3, 2 ) = the systemDate”
— “date( 2008, 3, 2 ) = _movie.systemDate()”
— “2008 = _movie.systemDate().year”
— “3 = _movie.systemDate().month”
— “2 = _movie.systemDate().day”
— “72861 = _movie.systemDate().seconds”
Here is the really quick explanation (as far as I know).
the ticks (or _movie.ticks) are divisions of time that are equal to approximately 1/60 of a second (slight variance on different platforms/computers). I’m not sure when they start counting (i.e. when would it show 0 ticks). the milliseconds (or _system.milliseconds) are the number of milliseconds (1/1000 of a second) that have passed since it started counting – and once again, I’m not sure when it starts counting. the date, _movie.date() and _system.date() all return the same value (at least in my case). I believe that the format of these will vary based on your international settings on your computer.
the long date provides the name of the day and the month. This is older Lingo. I’m not aware of a modern way to get this value. Does anyone know of anything such as _system.date.long() that might give the same information? The long date is rather unique (or should I say old?).
the time, _movie.time, and _system.time all provide the same value, but once again, there is the long time which includes the seconds and is unique and old. Does anyone know if there is a modern (dot syntax) version of that?
the systemDate (modern version is _system.date()) provides the date in the format of (year, month, day). This is supposed to be uniform across international systems. From this date you can easily get the year, month or day as was shown above. The most interesting part is that you can also get the seconds past midnight with the _movie.systemDate().seconds.
Between all those things you can usually come up with at least one time or date that seems interesting. Of course, if you want a bit more you could also use javascript or an actionscript object via lingo to get even more times and dates.
Some interesting resources related to this:
Director Online article
Mediamacros script
Using actionscript objects with date/time:
Director Dev Center Article
ActionScript dictionary for date objects
8 comments March 2nd, 2008