<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>date</title><revhistory><revision><revnumber>11</revnumber><date>2015-08-19 21:37:29</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>10</revnumber><date>2015-08-19 21:36:57</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>9</revnumber><date>2014-12-10 23:36:09</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>8</revnumber><date>2014-12-10 23:35:05</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>7</revnumber><date>2014-12-10 23:33:39</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>6</revnumber><date>2014-12-10 23:33:15</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>5</revnumber><date>2014-12-10 23:30:05</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>4</revnumber><date>2014-12-10 23:29:47</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>3</revnumber><date>2013-11-20 21:08:26</date><authorinitials>tech</authorinitials></revision><revision><revnumber>2</revnumber><date>2013-10-21 07:18:39</date><authorinitials>tech</authorinitials></revision><revision><revnumber>1</revnumber><date>2013-10-21 07:16:25</date><authorinitials>tech</authorinitials></revision></revhistory></articleinfo><section><title>date()</title><para>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. </para><para>The bot will internally apply the toString() method to it when date() is used in a manner that should return a string, for example <emphasis>echo date()</emphasis>.</para><para>If used in a method that would need a number, for example <emphasis>x = date() / 1000</emphasis> then the bot will internally apply the toNumber() method to it.  </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo date() // returns current time/date in human readable formatted string: </para></listitem><listitem override="none"><para><emphasis>Result:</emphasis> </para></listitem><listitem override="none"><para>Mon Oct 21 02:10:26 GMT-0500 2013 </para></listitem></itemizedlist><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo date(1418253379677) // returns time/date in human readable formatted string for specified timestamp: </para></listitem><listitem override="none"><para><emphasis>Result:</emphasis> </para></listitem><listitem override="none"><para>Wed Dec 10 18:16:19 GMT-0500 2014 </para></listitem></itemizedlist><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>current = date() // find the time elapsed between script start and script end </para></listitem><listitem override="none"><para>sleep 30 // just adding some time in between... </para></listitem><listitem override="none"><para>elapsed = floor((date() - current) / 1000) // dividing by 1000 because we want seconds not milliseconds </para></listitem><listitem override="none"><para>echo &quot;Time passed is &quot; + elapsed +  &quot; seconds.&quot; </para></listitem><listitem override="none"><para><emphasis>Result:</emphasis> </para></listitem><listitem override="none"><para>Debug on </para></listitem><listitem override="none"><para>Starting script </para></listitem><listitem override="none"><para>Running line 1 </para></listitem><listitem override="none"><para>current = Wed Dec 10 18:24:00 GMT-0500 2014 </para></listitem><listitem override="none"><para>Running line 2 </para></listitem><listitem override="none"><para>Sleeping 30 seconds until 06:24:30 PM </para></listitem><listitem override="none"><para>Running line 3 </para></listitem><listitem override="none"><para>elapsed = 32 </para></listitem><listitem override="none"><para>Running line 4 </para></listitem><listitem override="none"><para>Time passed is 32 seconds. // 30 seconds of sleep + a couple seconds of script run time </para></listitem></itemizedlist></section><section><title>Methods to use with date()</title><para><emphasis role="strong">date().getTime()</emphasis> //returns current timestamp as a number rather than string as shown above. </para><para><emphasis role="strong">date(timestamp).getMonth()</emphasis> // 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. </para><para><emphasis role="strong">date(timestamp).getDate()</emphasis> // returns the day of the month (integer number) for specified timestamp (or current time if timestamp is omitted).  </para><para><emphasis role="strong">date(timestamp).getDay()</emphasis> // 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. </para><para><emphasis role="strong">date(timestamp).getFullYear()</emphasis> // returns the year (integer number) for specified timestamp (or current time if timestamp is omitted).  </para><para><emphasis role="strong">date(timestamp).getHours()</emphasis> // returns hour (integer number) for specified timestamp (or current time if timestamp is omitted). </para><para><emphasis role="strong">date(timestamp).getMinutes()</emphasis> // returns minutes (integer number) for specified timestamp (or current time if timestamp is omitted). </para><para><emphasis role="strong">date(timestamp).getSeconds()</emphasis> // returns seconds (integer number) for specified timestamp (or current time if timestamp is omitted). </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="http://guide.neatportal.com/wiki/date/wiki/CategoryFunctions#">CategoryFunctions</ulink> </para></section></article>