Table des matières
datetime
Date de publication: le jeudi 31 mars 2011 à 22h36
Dernière modification: par Pascal BOYER le jeudi 31 mars 2011 à 23h37
toutes versions
Summary / Résumé
Formats dates/times according to settings in "datetime.ini".
Formate les dates et les heures en accord avec les paramètres du fichier de configuration datetime.ini
Usage / Utilisation
{input|datetime( preset_format [, format ] )}</pre>
Parameters / Paramères
|
Name Nom | Type | Description |
Required Requis |
|---|---|---|---|
| preset_format |
string chaîne de caractères |
Preset datetime format set in "datetime.ini". Format pré-défini, dans le fichier datetime.ini, de l'opérateur datetime |
Yes Oui |
| format |
string chaîne de caractères |
Custom format (when preset format is set to "custom"). Format personnalisé (lorsque le paramètre preset_format est positionné sur custom). |
No Non |
Returns / Renvoie
A string representation of the input parameter.
Une chaîne de caractères représentant le paramètre d'entrée.
Description
This operator takes care of formatting dates and times according to the setting defined in "datetime.ini" (or a configuration override). In addition, the operator also allows custom formats when the "preset_format" parameter is set to "custom". A custom format must be specified using the "format" parameter. The following table reveals the different elements that can be used in a custom format.
Cet opérateur formate les dates et les heures en tenant compte des paramètres définis dans le fichier de configuration datetime.ini (ou dans l'une de ses surcharges). Par ailleurs, cet opérateur permet également des formats de dates et d'heures personnalisés lorsque le paramètre preset_format est positionné sur custom. Le tableau ci-dessous présente les différents éléments disponibles pour personnaliser les formats:
| Elément |
Output Sortie | Description |
|---|---|---|
| %a | am |
Lowercase Ante meridiem and Post meridiem. Lettres minuscules de ante meridiem (am) et post meridiem (pm). |
| %A | AM |
Uppercase Ante meridiem and Post meridiem. Lettres majuscules de ANTE MERIDIEM (AM) et POST MERIDIEM (PM). |
| %d | 08 |
Day of the month, 2 digits with leading zeros. Jour du mois, 2 chiffres avec zéro. |
| %D | Wed |
A short textual representation of a day, in accordance with the "[ShortDayNames]" section of the language .INI file located in the "share/locale" directory. Une courte représentation textuelle du jour, en accord avec les paramètres de la section [ShortDayNames] du fichier de configuration de langue situé dans le répertoire share/locale/ |
| %F | October |
A full textual representation of a month, such as January or March. Une représentation textuelle complète du mois, comme par exemple Janvier ou Mars. |
| %g | 12 |
12-hour format of an hour without leading zeros. Heures au format 12 heures sans les zéros. |
| %G | 0 |
24-hour format of an hour without leading zeros. Heures au format 24 heures sans les zéros. |
| %h | 12 |
12-hour format of an hour with leading zeros. Heures au format 12 heures avec les zéros. |
| %H | 00 |
24-hour format of an hour with leading zeros. Heures au format 24 heures avec les zéros. |
| %i | 00 |
Minutes with leading zeros Format des minutes avec les zéros |
| %j | 8 |
Day of the month without leading zeros Jour du mois sans les zéros. |
| %l | Wednesday |
A full textual representation of the day of the week. Représentation textuelle complète du jour de la semaine. |
| %m | 10 |
Numeric representation of a month, with leading zeros. Représentation numérique du mois avec les zéros. |
| %M | Oct |
A short textual representation of a month, in accordance with the "[ShortMonthNames]" section of the language .INI file located in the "share/locale" directory. Une courte représentation textuelle du mois, en accord avec les paramètres de la section [ShortMonthNames] du fichier de configuration de langue situé dans le répertoire share/locale/ |
| %n | 10 |
Numeric representation of a month, without leading zeros. Représentation numérique du mois sans les zéros. |
| %O | -0500 |
Difference to Greenwich time (GMT) in hours. Différence, en heure, avec l'heure Greenwhich (GMT). |
| %s | 00 |
Seconds, with leading zeros. Les secondes avec les zéros. |
| %T | CDT |
Timezone setting of this machine. Zone horaire de la machine. |
| %U | 1065589200 |
Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT). Secondes écoulées depuis l'Epoque UNIX (1er janvier 1970 à 00:00:00 GMT) |
| %w | 3 |
Numeric representation of the day of the week. Représentation numérique du jour de la semaine. |
| %W | 41 |
ISO-8601 week number of year, weeks starting on Monday. Numéro de la semaine de l'année au format ISO-8601, les semaines commençant par Lundi. |
| %Y | 2003 |
A full numeric representation of a year, 4 digits. Représentation numérique complète de l'année sur 4 chiffres. |
| %y | 03 |
A two digit representation of a year. Représentation numérique de l'année sur deux chiffres. |
| %z | 280 |
The day of the year. Le jour de l'année. |
| %Z | -18000 |
Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. Offset/décalage en seconde de la zone horaire. L'offset des zones horaires ouest de UTC est toujours négatif et celui des zones horaires est de UTC toujours positif. |
The date used to generate the contents of this table was "12:00 AM (Midnight) CDT on October 8, 2003".
La date utilisée pour générer le contenu de ce tableau est 00:00 (minuit) CDT le 8 octobre 2003.
Exemple 1
{currentdate()|datetime( 'mydate' )}
The following output will be produced:
La sortie suivante sera produite:
"13:15 6 Feb 2004"
(according to the configuration settings).
(en accord avec les paramètres de configuration).
Exemple 2
{currentdate()|datetime( 'custom', '%h:%i %a %d %F %Y' )}
The following output will be produced:
La sortie suivante sera produite:
"01:15 pm 06 February 2004"
(custom format).
(format personnalisé).