date()

This function returns the Date object. You may optionally use a timestamp with this function in the format date(timestamp). If timestamp is not supplied then the current timestamp is used. The timestamp is the number of milliseconds that have passed since January 1st, 1970 at 00:00:00.

The bot will internally apply the toString() method to it when date() is used in a manner that should return a string, for example echo date().
If used in a method that would need a number, for example x = date() / 1000 then the bot will internally apply the toNumber() method to it.

Example:

• echo date() // returns current time/date in human readable formatted string:

• Result:

• Mon Oct 21 02:10:26 GMT-0500 2013

Example:

• echo date(1418253379677) // returns time/date in human readable formatted string for specified timestamp:

• Result:

• Wed Dec 10 18:16:19 GMT-0500 2014

Example:

• current = date() // find the time elapsed between script start and script end
• sleep 30 // just adding some time in between...
• elapsed = floor((date() - current) / 1000) // dividing by 1000 because we want seconds not milliseconds
• echo "Time passed is " + elapsed + " seconds."

• Result:

• Debug on
• Starting script
• Running line 1
• current = Wed Dec 10 18:24:00 GMT-0500 2014
• Running line 2
• Sleeping 30 seconds until 06:24:30 PM
• Running line 3
• elapsed = 32
• Running line 4
• Time passed is 32 seconds. // 30 seconds of sleep + a couple seconds of script run time

Methods to use with date()

date().getTime() //returns current timestamp as a number rather than string as shown above.

date(timestamp).getMonth() // returns the month (integer number) for specified timestamp (or current time if timestamp is omitted). It starts counting at 0 for January and ends at 11 for December.

date(timestamp).getDate() // returns the day of the month (integer number) for specified timestamp (or current time if timestamp is omitted).

date(timestamp).getDay() // returns the day of the week (integer number) for specified timestamp (or current time if timestamp is omitted). It starts counting at 0 for Sunday and ends at 6 for Saturday.

date(timestamp).getFullYear() // returns the year (integer number) for specified timestamp (or current time if timestamp is omitted).

date(timestamp).getHours() // returns hour (integer number) for specified timestamp (or current time if timestamp is omitted).

date(timestamp).getMinutes() // returns minutes (integer number) for specified timestamp (or current time if timestamp is omitted).

date(timestamp).getSeconds() // returns seconds (integer number) for specified timestamp (or current time if timestamp is omitted).

CategoryFunctions