Returns a reference to the global date object, only creating it if it doesn't already exist. The object returned will be of type JDate.


object JDate getDate( $time, $tzOffset )


Argument Data type Description Default
$time string or unsigned integer The date and time to use. To use the current (server) date and time use 'now'. The format to be used will depend on the current language and on whether the default Gregorian calendar has been overridden (which can only be done per language). See JLanguage for more information. If an integer is specified then the date is interpreted as a Unix timestamp. 'now'
$tzOffset signed integer The timezone offset to apply to the data and time in $time. This is subtracted from the $time when calculating the date/time so that the date saved in the date object is in UT (often referred to as GMT). See the examples below. 0

Example 1

In this example, the current date and time is retrieved and output in the current default locale format.

$date =& JFactory::getDate();
echo 'Current date and time is: ' . $date->format() . "\n";

If the current language is English then this will output something like

Current date and time is: 2008-11-22 18:14:08

Example 2

In this example, a date is specified (using the English Gregorian calendar) and output in RFC2822 format suitable for use in most internet protocols. Note that for this to work the date must be specified in the current locale format or the date parser may not recognise it. A timezone offset of +1 is also specified, perhaps indicating that the date is in Central European Time (CET) which is one hour ahead of UT. Notice how the time output has been adjusted to UT.

$date =& JFactory::getDate( '16 April 2008 14:30:00', 1 );
echo 'Date and time is: ' . $date->toRFC822() . "\n";

Which will output this

Date and time is: Wed, 16 Apr 2008 13:30:00 +0000

Example 3

In this example, the date is specified as a Unix timestamp and output in ISO 8601 format.

$date =& JFactory::getDate( 1332362632 );
echo 'Date and time is: ' . $date->toISO8601() . "\n";

Which will output this

Date and time is: 2012-03-21T20:43:52Z

See also