Joomla Platform  13.1
Documentation des API du framework Joomla Platform
 Tout Classes Espaces de nommage Fichiers Fonctions Variables Pages
Fonctions membres publiques | Fonctions membres publiques statiques | Attributs publics | Attributs publics statiques | Attributs protégés | Attributs protégés statiques
Référence de la classe JDate

Liste de tous les membres

Fonctions membres publiques

 __construct ($date= 'now', $tz=null)
 __get ($name)
 __toString ()
 dayToString ($day, $abbr=false)
 calendar ($format, $local=false, $translate=true)
 format ($format, $local=false, $translate=true)
 getOffsetFromGMT ($hours=false)
 monthToString ($month, $abbr=false)
 setTimezone ($tz)
 toISO8601 ($local=false)
 toSql ($local=false, JDatabaseDriver $db=null)
 toRFC822 ($local=false)
 toUnix ()

Fonctions membres publiques statiques

static getInstance ($date= 'now', $tz=null)

Attributs publics

const DAY_ABBR = "\x021\x03"
const DAY_NAME = "\x022\x03"
const MONTH_ABBR = "\x023\x03"
const MONTH_NAME = "\x024\x03"

Attributs publics statiques

static $format = 'Y-m-d H:i:s'

Attributs protégés

 $tz

Attributs protégés statiques

static $gmt
static $stz

Description détaillée

Définition à la ligne 33 du fichier date.php.

Documentation des constructeurs et destructeur

JDate::__construct (   $date = 'now',
  $tz = null 
)

Constructor.

Paramètres:
string$dateString in a format accepted by strtotime(), defaults to "now".
mixed$tzTime zone to be used for the date. Might be a string or a DateTimeZone object.
Depuis:
11.1

Définition à la ligne 81 du fichier date.php.

{
// Create the base GMT and server time zone objects.
if (empty(self::$gmt) || empty(self::$stz))
{
self::$gmt = new DateTimeZone('GMT');
self::$stz = new DateTimeZone(@date_default_timezone_get());
}
// If the time zone object is not set, attempt to build it.
if (!($tz instanceof DateTimeZone))
{
if ($tz === null)
{
$tz = self::$gmt;
}
elseif (is_string($tz))
{
$tz = new DateTimeZone($tz);
}
}
// If the date is numeric assume a unix timestamp and convert it.
date_default_timezone_set('UTC');
$date = is_numeric($date) ? date('c', $date) : $date;
// Call the DateTime constructor.
parent::__construct($date, $tz);
// Reset the timezone for 3rd party libraries/extension that does not use JDate
date_default_timezone_set(self::$stz->getName());
// Set the timezone object for access later.
$this->tz = $tz;
}

Documentation des fonctions membres

JDate::__get (   $name)

Magic method to access properties of the date given by class to the format method.

Paramètres:
string$nameThe name of the property.
Renvoie:
mixed A value if the property name is valid, null otherwise.
Depuis:
11.1

Définition à la ligne 126 du fichier date.php.

{
$value = null;
switch ($name)
{
case 'daysinmonth':
$value = $this->format('t', true);
break;
case 'dayofweek':
$value = $this->format('N', true);
break;
case 'dayofyear':
$value = $this->format('z', true);
break;
case 'isleapyear':
$value = (boolean) $this->format('L', true);
break;
case 'day':
$value = $this->format('d', true);
break;
case 'hour':
$value = $this->format('H', true);
break;
case 'minute':
$value = $this->format('i', true);
break;
case 'second':
$value = $this->format('s', true);
break;
case 'month':
$value = $this->format('m', true);
break;
case 'ordinal':
$value = $this->format('S', true);
break;
case 'week':
$value = $this->format('W', true);
break;
case 'year':
$value = $this->format('Y', true);
break;
default:
$trace = debug_backtrace();
trigger_error(
'Undefined property via __get(): ' . $name . ' in ' . $trace[0]['file'] . ' on line ' . $trace[0]['line'],
E_USER_NOTICE
);
}
return $value;
}
JDate::__toString ( )

Magic method to render the date object in the format specified in the public static member JDate::$format.

Renvoie:
string The date as a formatted string.
Depuis:
11.1

Définition à la ligne 199 du fichier date.php.

{
return (string) parent::format(self::$format);
}
JDate::calendar (   $format,
  $local = false,
  $translate = true 
)

Gets the date as a formatted string in a local calendar.

Paramètres:
string$formatThe date format specification string (see PHP_MANUAL#date)
boolean$localTrue to return the date string in the local time zone, false to return it in GMT.
boolean$translateTrue to translate localised strings
Renvoie:
string The date string in the specified format format.
Depuis:
11.1

Définition à la ligne 261 du fichier date.php.

{
return $this->format($format, $local, $translate);
}
JDate::dayToString (   $day,
  $abbr = false 
)

Translates day of week number to a string.

Paramètres:
integer$dayThe numeric day of the week.
boolean$abbrReturn the abbreviated day string?
Renvoie:
string The day of the week.
Depuis:
11.1

Définition à la ligne 229 du fichier date.php.

Références JText\_().

{
switch ($day)
{
case 0:
return $abbr ? JText::_('SUN') : JText::_('SUNDAY');
case 1:
return $abbr ? JText::_('MON') : JText::_('MONDAY');
case 2:
return $abbr ? JText::_('TUE') : JText::_('TUESDAY');
case 3:
return $abbr ? JText::_('WED') : JText::_('WEDNESDAY');
case 4:
return $abbr ? JText::_('THU') : JText::_('THURSDAY');
case 5:
return $abbr ? JText::_('FRI') : JText::_('FRIDAY');
case 6:
return $abbr ? JText::_('SAT') : JText::_('SATURDAY');
}
}

+ Voici le graphe d'appel pour cette fonction :

JDate::format (   $format,
  $local = false,
  $translate = true 
)

Gets the date as a formatted string.

Paramètres:
string$formatThe date format specification string (see PHP_MANUAL#date)
boolean$localTrue to return the date string in the local time zone, false to return it in GMT.
boolean$translateTrue to translate localised strings
Renvoie:
string The date string in the specified format format.
Depuis:
11.1

Définition à la ligne 277 du fichier date.php.

{
if ($translate)
{
// Do string replacements for date format options that can be translated.
$format = preg_replace('/(^|[^\\\])D/', "\\1" . self::DAY_ABBR, $format);
$format = preg_replace('/(^|[^\\\])l/', "\\1" . self::DAY_NAME, $format);
$format = preg_replace('/(^|[^\\\])M/', "\\1" . self::MONTH_ABBR, $format);
$format = preg_replace('/(^|[^\\\])F/', "\\1" . self::MONTH_NAME, $format);
}
// If the returned time should not be local use GMT.
if ($local == false)
{
parent::setTimezone(self::$gmt);
}
// Format the date.
$return = parent::format($format);
if ($translate)
{
// Manually modify the month and day strings in the formatted time.
if (strpos($return, self::DAY_ABBR) !== false)
{
$return = str_replace(self::DAY_ABBR, $this->dayToString(parent::format('w'), true), $return);
}
if (strpos($return, self::DAY_NAME) !== false)
{
$return = str_replace(self::DAY_NAME, $this->dayToString(parent::format('w')), $return);
}
if (strpos($return, self::MONTH_ABBR) !== false)
{
$return = str_replace(self::MONTH_ABBR, $this->monthToString(parent::format('n'), true), $return);
}
if (strpos($return, self::MONTH_NAME) !== false)
{
$return = str_replace(self::MONTH_NAME, $this->monthToString(parent::format('n')), $return);
}
}
if ($local == false)
{
parent::setTimezone($this->tz);
}
return $return;
}
static JDate::getInstance (   $date = 'now',
  $tz = null 
)
static

Proxy for new JDate().

Paramètres:
string$dateString in a format accepted by strtotime(), defaults to "now".
mixed$tzTime zone to be used for the date.
Renvoie:
JDate
Depuis:
11.3

Définition à la ligne 214 du fichier date.php.

{
return new JDate($date, $tz);
}
JDate::getOffsetFromGMT (   $hours = false)

Get the time offset from GMT in hours or seconds.

Paramètres:
boolean$hoursTrue to return the value in hours.
Renvoie:
float The time offset from GMT either in hours or in seconds.
Depuis:
11.1

Définition à la ligne 338 du fichier date.php.

{
return (float) $hours ? ($this->tz->getOffset($this) / 3600) : $this->tz->getOffset($this);
}
JDate::monthToString (   $month,
  $abbr = false 
)

Translates month number to a string.

Paramètres:
integer$monthThe numeric month of the year.
boolean$abbrIf true, return the abbreviated month string
Renvoie:
string The month of the year.
Depuis:
11.1

Définition à la ligne 353 du fichier date.php.

Références JText\_().

{
switch ($month)
{
case 1:
return $abbr ? JText::_('JANUARY_SHORT') : JText::_('JANUARY');
case 2:
return $abbr ? JText::_('FEBRUARY_SHORT') : JText::_('FEBRUARY');
case 3:
return $abbr ? JText::_('MARCH_SHORT') : JText::_('MARCH');
case 4:
return $abbr ? JText::_('APRIL_SHORT') : JText::_('APRIL');
case 5:
return $abbr ? JText::_('MAY_SHORT') : JText::_('MAY');
case 6:
return $abbr ? JText::_('JUNE_SHORT') : JText::_('JUNE');
case 7:
return $abbr ? JText::_('JULY_SHORT') : JText::_('JULY');
case 8:
return $abbr ? JText::_('AUGUST_SHORT') : JText::_('AUGUST');
case 9:
return $abbr ? JText::_('SEPTEMBER_SHORT') : JText::_('SEPTEMBER');
case 10:
return $abbr ? JText::_('OCTOBER_SHORT') : JText::_('OCTOBER');
case 11:
return $abbr ? JText::_('NOVEMBER_SHORT') : JText::_('NOVEMBER');
case 12:
return $abbr ? JText::_('DECEMBER_SHORT') : JText::_('DECEMBER');
}
}

+ Voici le graphe d'appel pour cette fonction :

JDate::setTimezone (   $tz)

Method to wrap the setTimezone() function and set the internal time zone object.

Paramètres:
DateTimeZone$tzThe new DateTimeZone object.
Renvoie:
JDate
Depuis:
11.1
Note:
This method can't be type hinted due to a PHP bug: https://bugs.php.net/bug.php?id=61483

Définition à la ligne 394 du fichier date.php.

{
$this->tz = $tz;
return parent::setTimezone($tz);
}
JDate::toISO8601 (   $local = false)

Gets the date as an ISO 8601 string. IETF RFC 3339 defines the ISO 8601 format and it can be found at the IETF Web site.

Paramètres:
boolean$localTrue to return the date string in the local time zone, false to return it in GMT.
Renvoie:
string The date string in ISO 8601 format.

11.1

Définition à la ligne 412 du fichier date.php.

{
return $this->format(DateTime::RFC3339, $local, false);
}
JDate::toRFC822 (   $local = false)

Gets the date as an RFC 822 string. IETF RFC 2822 supercedes RFC 822 and its definition can be found at the IETF Web site.

Paramètres:
boolean$localTrue to return the date string in the local time zone, false to return it in GMT.
Renvoie:
string The date string in RFC 822 format.

11.1

Définition à la ligne 449 du fichier date.php.

{
return $this->format(DateTime::RFC2822, $local, false);
}
JDate::toSql (   $local = false,
JDatabaseDriver  $db = null 
)

Gets the date as an SQL datetime string.

Paramètres:
boolean$localTrue to return the date string in the local time zone, false to return it in GMT.
JDatabaseDriver$dbThe database driver or null to use JFactory::getDbo()
Renvoie:
string The date string in SQL datetime format.

11.4

Définition à la ligne 428 du fichier date.php.

Références JFactory\getDbo().

{
if ($db === null)
{
$db = JFactory::getDbo();
}
return $this->format($db->getDateFormat(), $local, false);
}

+ Voici le graphe d'appel pour cette fonction :

JDate::toUnix ( )

Gets the date as UNIX time stamp.

Renvoie:
integer The date as a UNIX timestamp.
Depuis:
11.1

Définition à la ligne 461 du fichier date.php.

{
return (int) parent::format('U');
}

Documentation des données membres

JDate::$format = 'Y-m-d H:i:s'
static

Définition à la ligne 46 du fichier date.php.

JDate::$gmt
staticprotected

Définition à la ligne 54 du fichier date.php.

JDate::$stz
staticprotected

Définition à la ligne 63 du fichier date.php.

JDate::$tz
protected

Définition à la ligne 71 du fichier date.php.

const JDate::DAY_ABBR = "\x021\x03"

Définition à la ligne 35 du fichier date.php.

const JDate::DAY_NAME = "\x022\x03"

Définition à la ligne 36 du fichier date.php.

const JDate::MONTH_ABBR = "\x023\x03"

Définition à la ligne 37 du fichier date.php.

const JDate::MONTH_NAME = "\x024\x03"

Définition à la ligne 38 du fichier date.php.

La documentation de cette classe a été générée à partir du fichier suivant :