Joomla! Documentation - User contributions [en]

Calendar form field type

2019-10-05T18:04:58Z

Garstud: adding explanation on multiple possibles default values

<noinclude><languages /></noinclude>
<translate>
The '''calendar''' form field type provides a text box for entry of a date. An icon next to the text box provides a link to a pop-up calendar, which can also be used to enter the date value. If the field has a saved value this is shown in the text box. Otherwise the default value, if any, is displayed.</translate>

[[Image:DatePicker1.calendar-<translate>
en</translate>.png|right]]
<translate>
* '''type''' (mandatory) must be ''calendar''.</translate>
<translate>
* '''name''' (mandatory) is the unique name of the field.</translate>
<translate>
* '''label''' (mandatory) (translatable) is the descriptive title of the field.</translate>
<translate>
* '''default''' (optional) is the default date. This must be given in the same format as specified by the format argument. You can put "NOW" to have current date or time information in the given format. You can also used any [[https://docs.joomla.org/How_to_use_JDate#Arguments JDate arguments]] ('now +1 month', 'now +2 months +7 days +12 hours', ...)</translate>
<translate>
* '''description''' (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the text box.</translate>
<translate>
* '''readonly''' (optional) is whether the text box is read-only (''true'' or ''false''). If the text box is read-only, the date cannot be changed, but can be selected and copied. No calendar icon will be shown.</translate>
<translate>
* '''disabled''' (optional) is whether the text box is disabled (''true'' or ''false''). If the text box is disabled, the date cannot be changed, selected or copied.</translate>
<translate>
* '''class''' (optional) is a CSS class name for the HTML form field. It is recommended to use the "Bootstrap2 Relatives sizing" (see code examples below).</translate>
<translate>
* '''format''' (optional) is the date format to be used. This is in the format used by PHP to specify date string formats (see below). If no format argument is given, '%Y-%m-%d' is assumed (giving dates like '2017-05-15'). If <code>showtime</code> is true then you will need to include some time fields, for example, '%Y-%m-%d %H:%M:%S'.</translate>
<translate>
* '''filter''' (optional) is time zone to be used. There are two values; server_utc and user_utc. The first one is server time zone and the later is user time zone as configured in global configuration and user information respectively.</translate>
<translate>

* '''translateformat''' (optional): If set to true, the calendar will use the <code>DATE_FORMAT_CALENDAR_DATE</code> language key (if <code>showtime</code> is true) or <code>DATE_FORMAT_CALENDAR_DATETIME</code> (if <code>showtime</code> is false) to determine the format. The <code>format</code> attribute is ignored. If false, the <code>format</code> attribute is used (same behaviour as prior to 3.7.0) but note that the <code>format</code> string must include time fields for the time to be recorded. Defaults to false.</translate>
<translate>

* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0). Defaults to false.</translate>

<translate>

* '''timeformat''' (optional): can be set to 12 or 24 (starting with 3.7.0). If set to 12, an additional selection is available to the user to choose between AM and PM. This attribute does not affect how the date/time is saved. Defaults to 24.</translate>

<translate>

* '''singleheader''' (optional): if set to false, the year and the month selection will be set on two separates lines, with independent selection (starting with 3.7.0). Defaults to false.</translate>

<translate>

* '''todaybutton''' (optional): if set to true, a button is added at the bottom of the date picker to select the date of the current day (starting with 3.7.0). Defaults to true.</translate>

<translate>

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the date picker to display the number of the week in the current year (starting with 3.7.0). Defaults to true.</translate>

<translate>

* '''filltable''' (optional): if set to true, dates of the previous and next month are added at the top and bottom of the current month to fill the grid (starting with 3.7.0). Defaults to true.</translate>

<translate>

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user cannot select a year before this limit (starting with 3.7.0). If zero, which is the default, there is no limit.</translate>

<translate>

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user cannot select a year after this limit (starting with 3.7.0). If zero, which is the default, there is no limit.</translate>

<translate>
Example for a light DatePicker XML field definition:</translate>
<source lang="xml"><field name="<translate>
mycalendar</translate>" type="calendar" default="<translate>
2017-05-15</translate>" label="<translate>
Select a date</translate>" description=""
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-<translate>
en</translate>.png|center]]

<translate>

Example for an advanced DatePicker XML field definition:</translate>
<source lang="xml"><field name="<translate>
mycalendar</translate>" type="calendar" default="<translate>
2017-05-15</translate>" label="<translate>
Select a date</translate>" description=""
class="input-medium" required="true" filter="user_utc" format="<translate>
%Y-%m-%d %H:%M:%S</translate>"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-<translate>
en</translate>.png|center]]

<translate>
The format attribute specifies the format that the date string will be saved in. It is also the format that manually entered dates need to be enterered in; except that the punctuation character is ignored. The coding scheme used to specify date formats is a custom one defined for the javascript library used in the datepicker, full details of which can be found for example on [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 Joomla's Github].</translate>
<translate>
The following are some of the most frequently used date string codes:</translate>

{| class="wikitable"
|-
!<translate>
Character</translate>
!<translate>
Description</translate>
!<translate>
Example</translate>
|-
|d
|<translate>
Day of the month, 2 digits with leading zeros</translate>
|<translate>
01 to 31</translate>
|-
|a
|<translate>
A textual representation of a day, three letters</translate>
|<translate>
Mon through Sun</translate>
|-
|e
|<translate>
Day of the month without leading zeros</translate>
|<translate>
1 to 31</translate>
|-
|A
|<translate>
A full textual representation of the day of the week</translate>
|<translate>
Monday through Sunday</translate>
|-
|w
|<translate>
Numeric representation of the day of the week</translate>
|<translate>
0 (for Sunday) through 6 (for Saturday)</translate>
|-
|j
|<translate>
The day of the year (starting from 0)</translate>
|<translate>
001 through 366</translate>
|-
|B
|<translate>
A full textual representation of a month</translate>
|<translate>
January through December</translate>
|-
|m
|<translate>
Numeric representation of a month, with leading zeros</translate>
|<translate>
01 through 12</translate>
|-
|b
|<translate>
A short textual representation of a month, three letters</translate>
|<translate>
Jan through Dec</translate>
|-
|Y
|<translate>
A full numeric representation of a year, 4 digits</translate>
|<translate>
1999 or 2003</translate>
|-
|y
|<translate>
A two-digit representation of a year</translate>
|<translate>
99 or 03</translate>
|-
|P
|<translate>
Lowercase Ante Meridiem or Post Meridiem</translate>
|<translate>
am or pm</translate>
|-
|p
|<translate>
Uppercase Ante Meridiem or Post Meridiem</translate>
|<translate>
AM or PM</translate>
|}

<translate>
Note: The format in which dates are stored in the params.ini file is that specified by the format argument. Since there can be language-dependent elements to this format (for example, the '%A' specifier), you need to be careful not to use such elements if there is a possibility that the front-end and back-end languages may be different.</translate>

<translate>
Note: The calendar form field type does not support non-Gregorian calendars. If you need to support non-Gregorian calendars then you will need to create a custom form field type to support your calendar.</translate>

<translate>=== Standard associated filters === </translate>
<translate>
* '''user_utc''' - Calculates the specified value to the time of Greenwich, according to the user time zone settings.</translate>

<translate>=== See also === </translate>
<translate>
* [[S:MyLanguage/Standard form field types|List of standard form field types]]</translate>

<noinclude>
<translate>

[[Category:Standard form field types]]
</translate>
</noinclude>

User:Garstud

2018-03-27T20:41:13Z

Garstud: Created page with "== My Profile == Joomla web developer Freelance and active member of the French community.<br /> location : Aix-en-Provence, France south == My subjects in the wiki == Anyth..."

== My Profile ==
Joomla web developer Freelance and active member of the French community.<br />

location : Aix-en-Provence, France south

== My subjects in the wiki ==
Anything that can help developers, such as : <br />
XML fields, custom fields, extensions dev technics, widgets of recurrent code ...

Calendar form field type/fr

2017-05-18T11:05:15Z

Garstud: Created page with "Renseignez une date"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (optional): can be set to 12 (and specify AM or PM) or 24 (starting with 3.7.0)

* '''singleheader''' (optional): if set to false, the year and the month selection will be set on two separates lines, with independant selection (starting with 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom of the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current month to fill the grid (starting with 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Renseignez une date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Renseignez une date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%d-%m-%Y"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/69/fr

2017-05-18T11:05:15Z

Garstud: Created page with "Renseignez une date"

Renseignez une date

Calendar form field type/fr

2017-05-18T11:04:36Z

Garstud: Created page with "%d-%m-%Y"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Renseignez une date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%d-%m-%Y"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/70/fr

2017-05-18T11:04:35Z

Garstud: Created page with "%d-%m-%Y"

%d-%m-%Y

Calendar form field type/fr

2017-05-18T11:04:03Z

Garstud: Created page with "15-05-2017"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Renseignez une date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/68/fr

2017-05-18T11:04:03Z

Garstud: Created page with "15-05-2017"

15-05-2017

Calendar form field type/fr

2017-05-18T11:04:00Z

Garstud: Created page with "madate"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Renseignez une date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="madate" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/67/fr

2017-05-18T11:04:00Z

Garstud: Created page with "madate"

madate

Calendar form field type/fr

2017-05-18T11:03:43Z

Garstud: Created page with "Renseignez une date"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Renseignez une date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/66/fr

2017-05-18T11:03:43Z

Garstud: Created page with "Renseignez une date"

Renseignez une date

Calendar form field type/fr

2017-05-18T11:03:14Z

Garstud: Created page with "15-05-2017"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="15-05-2017" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/65/fr

2017-05-18T11:03:14Z

Garstud: Created page with "15-05-2017"

15-05-2017

Calendar form field type/fr

2017-05-18T11:02:44Z

Garstud: Created page with "madate"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="madate" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/64/fr

2017-05-18T11:02:44Z

Garstud: Created page with "madate"

madate

Calendar form field type

2017-05-18T10:59:54Z

Garstud:

<noinclude><languages /></noinclude>
<translate>
The '''calendar''' form field type provides a text box for entry of a date. An icon next to the text box provides a link to a pop-up calendar, which can also be used to enter the date value. If the field has a saved value this is shown in the text box. Otherwise the default value, if any, is displayed.</translate>
<translate>
[[Image:DatePicker1.calendar-en.png|right]]</translate>
<translate>
* '''type''' (mandatory) must be ''calendar''.</translate>
<translate>
* '''name''' (mandatory) is the unique name of the field.</translate>
<translate>
* '''label''' (mandatory) (translatable) is the descriptive title of the field.</translate>
<translate>
* '''default''' (optional) is the default date. This must be given in the same format as specified by the format argument. You can put "NOW" to have current date or time information in the given format.</translate>
<translate>
* '''description''' (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the text box.</translate>
<translate>
* '''readonly''' (optional) is whether the text box is read-only (''true'' or ''false''). If the text box is read-only, the date cannot be changed, but can be selected and copied. No calendar icon will be shown.</translate>
<translate>
* '''disabled''' (optional) is whether the text box is disabled (''true'' or ''false''). If the text box is disabled, the date cannot be changed, selected or copied.</translate>
<translate>
* '''class''' (optional) is a CSS class name for the HTML form field. It is recommended to use the "Bootstrap2 Relatives sizing" (see code examples below).</translate>
<translate>
* '''format''' (optional) is the date format to be used. This is in the format used by PHP to specify date string formats (see below). If no format argument is given, '%Y-%m-%d' is assumed (giving dates like '2017-05-15').</translate>
<translate>
* '''filter''' (optional) is time zone to be used. There are two values; server_utc and user_utc. The first one is server time zone and the later is user time zone as configured in global configuration and user information respectively.</translate>
<translate>

* '''translateformat''' (optional): If set to true, the calendar will use a language string to determine the format. The `format` attribute is ignored. If false, the `format` attribute is used (same behaviour as today). (starting with 3.7.0)</translate>
<translate>

* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)</translate>

<translate>

* '''timeformat''' (optional): can be set to 12 (and specify AM or PM) or 24 (starting with 3.7.0)</translate>

<translate>

* '''singleheader''' (optional): if set to false, the year and the month selection will be set on two separates lines, with independant selection (starting with 3.7.0)</translate>

<translate>

* '''todaybutton''' (optional): if set to true, a button is added at the bottom of the datePicker to select the date of the current day (starting with 3.7.0)</translate>

<translate>

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)</translate>

<translate>

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current month to fill the grid (starting with 3.7.0)</translate>

<translate>

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)</translate>

<translate>

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)</translate>

<translate>
Example for a light DatePicker XML field definition:</translate>
<source lang="xml"><field name="<translate>mycalendar</translate>" type="calendar" default="<translate>2017-05-15</translate>" label="<translate>Select a date</translate>" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-<translate>
en</translate>.png|center]]

<translate>

Example for an advanced DatePicker XML field definition:</translate>
<source lang="xml"><field name="<translate>mycalendar</translate>" type="calendar" default="<translate>2017-05-15</translate>" label="<translate>Select a date</translate>" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="<translate>%Y-%m-%d</translate>"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-<translate>
en</translate>.png|center]]

<translate>
The format attribute specifies the format that the date string will be saved in. It is also the format that manually entered dates need to be enterered in; except that the punctuation character is ignored. The coding scheme used to specify date formats is a custom one defined for the javascript library used in the datepicker, full details of which can be found for example on [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 Joomla's Github].</translate>
<translate>
The following are some of the most frequently used date string codes:</translate>

{| class="wikitable"
|-
!<translate>
Character</translate>
!<translate>
Description</translate>
!<translate>
Example</translate>
|-
|d
|<translate>
Day of the month, 2 digits with leading zeros</translate>
|<translate>
01 to 31</translate>
|-
|a
|<translate>
A textual representation of a day, three letters</translate>
|<translate>
Mon through Sun</translate>
|-
|e
|<translate>
Day of the month without leading zeros</translate>
|<translate>
1 to 31</translate>
|-
|A
|<translate>
A full textual representation of the day of the week</translate>
|<translate>
Monday through Sunday</translate>
|-
|w
|<translate>
Numeric representation of the day of the week</translate>
|<translate>
0 (for Sunday) through 6 (for Saturday)</translate>
|-
|j
|<translate>
The day of the year (starting from 0)</translate>
|<translate>
001 through 366</translate>
|-
|B
|<translate>
A full textual representation of a month</translate>
|<translate>
January through December</translate>
|-
|m
|<translate>
Numeric representation of a month, with leading zeros</translate>
|<translate>
01 through 12</translate>
|-
|b
|<translate>
A short textual representation of a month, three letters</translate>
|<translate>
Jan through Dec</translate>
|-
|Y
|<translate>
A full numeric representation of a year, 4 digits</translate>
|<translate>
1999 or 2003</translate>
|-
|y
|<translate>
A two-digit representation of a year</translate>
|<translate>
99 or 03</translate>
|-
|p
|<translate>
Lowercase Ante Meridiem or Post Meridiem</translate>
|<translate>
am or pm</translate>
|-
|P
|<translate>
Uppercase Ante Meridiem or Post Meridiem</translate>
|<translate>
AM or PM</translate>
|}

<translate>
Note: The format in which dates are stored in the params.ini file is that specified by the format argument. Since there can be language-dependent elements to this format (for example, the '%A' specifier), you need to be careful not to use such elements if there is a possibility that the front-end and back-end languages may be different.</translate>

<translate>
Note: The calendar form field type does not support non-Gregorian calendars. If you need to support non-Gregorian calendars then you will need to create a custom form field type to support your calendar.</translate>

<translate>=== Standard associated filters === </translate>
<translate>
* '''user_utc''' - Calculates the specified value to the time of Greenwich, according to the user time zone settings.</translate>

<translate>=== See also === </translate>
<translate>
* [[S:MyLanguage/Standard form field types|List of standard form field types]]</translate>

<noinclude>
<translate>

[[Category:Standard form field types]]
</translate>
</noinclude>

Calendar form field type

2017-05-18T10:56:18Z

Garstud:

<noinclude><languages /></noinclude>
<translate>
The '''calendar''' form field type provides a text box for entry of a date. An icon next to the text box provides a link to a pop-up calendar, which can also be used to enter the date value. If the field has a saved value this is shown in the text box. Otherwise the default value, if any, is displayed.</translate>
<translate>
[[Image:DatePicker1.calendar-en.png|right]]</translate>
<translate>
* '''type''' (mandatory) must be ''calendar''.</translate>
<translate>
* '''name''' (mandatory) is the unique name of the field.</translate>
<translate>
* '''label''' (mandatory) (translatable) is the descriptive title of the field.</translate>
<translate>
* '''default''' (optional) is the default date. This must be given in the same format as specified by the format argument. You can put "NOW" to have current date or time information in the given format.</translate>
<translate>
* '''description''' (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the text box.</translate>
<translate>
* '''readonly''' (optional) is whether the text box is read-only (''true'' or ''false''). If the text box is read-only, the date cannot be changed, but can be selected and copied. No calendar icon will be shown.</translate>
<translate>
* '''disabled''' (optional) is whether the text box is disabled (''true'' or ''false''). If the text box is disabled, the date cannot be changed, selected or copied.</translate>
<translate>
* '''class''' (optional) is a CSS class name for the HTML form field. It is recommended to use the "Bootstrap2 Relatives sizing" (see code examples below).</translate>
<translate>
* '''format''' (optional) is the date format to be used. This is in the format used by PHP to specify date string formats (see below). If no format argument is given, '%Y-%m-%d' is assumed (giving dates like '2017-05-15').</translate>
<translate>
* '''filter''' (optional) is time zone to be used. There are two values; server_utc and user_utc. The first one is server time zone and the later is user time zone as configured in global configuration and user information respectively.</translate>
<translate>

* '''translateformat''' (optional): If set to true, the calendar will use a language string to determine the format. The `format` attribute is ignored. If false, the `format` attribute is used (same behaviour as today). (starting with 3.7.0)</translate>
<translate>

* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)</translate>

<translate>

* '''timeformat''' (optional): can be set to 12 (and specify AM or PM) or 24 (starting with 3.7.0)</translate>

<translate>

* '''singleheader''' (optional): if set to false, the year and the month selection will be set on two separates lines, with independant selection (starting with 3.7.0)</translate>

<translate>

* '''todaybutton''' (optional): if set to true, a button is added at the bottom of the datePicker to select the date of the current day (starting with 3.7.0)</translate>

<translate>

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)</translate>

<translate>

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current month to fill the grid (starting with 3.7.0)</translate>

<translate>

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)</translate>

<translate>

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)</translate>

<translate>
Example for a light DatePicker XML field definition:</translate>
<source lang="xml"><field name="mycalendar" type="calendar" default="<translate>2017-05-15</translate>" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-<translate>
en</translate>.png|center]]

<translate>

Example for an advanced DatePicker XML field definition:</translate>
<source lang="xml"><field name="mycalendar" type="calendar" default="<translate>2017-05-15</translate>" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-<translate>
en</translate>.png|center]]

<translate>
The format attribute specifies the format that the date string will be saved in. It is also the format that manually entered dates need to be enterered in; except that the punctuation character is ignored. The coding scheme used to specify date formats is a custom one defined for the javascript library used in the datepicker, full details of which can be found for example on [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 Joomla's Github].</translate>
<translate>
The following are some of the most frequently used date string codes:</translate>

{| class="wikitable"
|-
!<translate>
Character</translate>
!<translate>
Description</translate>
!<translate>
Example</translate>
|-
|d
|<translate>
Day of the month, 2 digits with leading zeros</translate>
|<translate>
01 to 31</translate>
|-
|a
|<translate>
A textual representation of a day, three letters</translate>
|<translate>
Mon through Sun</translate>
|-
|e
|<translate>
Day of the month without leading zeros</translate>
|<translate>
1 to 31</translate>
|-
|A
|<translate>
A full textual representation of the day of the week</translate>
|<translate>
Monday through Sunday</translate>
|-
|w
|<translate>
Numeric representation of the day of the week</translate>
|<translate>
0 (for Sunday) through 6 (for Saturday)</translate>
|-
|j
|<translate>
The day of the year (starting from 0)</translate>
|<translate>
001 through 366</translate>
|-
|B
|<translate>
A full textual representation of a month</translate>
|<translate>
January through December</translate>
|-
|m
|<translate>
Numeric representation of a month, with leading zeros</translate>
|<translate>
01 through 12</translate>
|-
|b
|<translate>
A short textual representation of a month, three letters</translate>
|<translate>
Jan through Dec</translate>
|-
|Y
|<translate>
A full numeric representation of a year, 4 digits</translate>
|<translate>
1999 or 2003</translate>
|-
|y
|<translate>
A two-digit representation of a year</translate>
|<translate>
99 or 03</translate>
|-
|p
|<translate>
Lowercase Ante Meridiem or Post Meridiem</translate>
|<translate>
am or pm</translate>
|-
|P
|<translate>
Uppercase Ante Meridiem or Post Meridiem</translate>
|<translate>
AM or PM</translate>
|}

<translate>
Note: The format in which dates are stored in the params.ini file is that specified by the format argument. Since there can be language-dependent elements to this format (for example, the '%A' specifier), you need to be careful not to use such elements if there is a possibility that the front-end and back-end languages may be different.</translate>

<translate>
Note: The calendar form field type does not support non-Gregorian calendars. If you need to support non-Gregorian calendars then you will need to create a custom form field type to support your calendar.</translate>

<translate>=== Standard associated filters === </translate>
<translate>
* '''user_utc''' - Calculates the specified value to the time of Greenwich, according to the user time zone settings.</translate>

<translate>=== See also === </translate>
<translate>
* [[S:MyLanguage/Standard form field types|List of standard form field types]]</translate>

<noinclude>
<translate>

[[Category:Standard form field types]]
</translate>
</noinclude>

Calendar form field type

2017-05-18T10:50:28Z

Garstud: add translate tag on source code examples

<noinclude><languages /></noinclude>
<translate>
The '''calendar''' form field type provides a text box for entry of a date. An icon next to the text box provides a link to a pop-up calendar, which can also be used to enter the date value. If the field has a saved value this is shown in the text box. Otherwise the default value, if any, is displayed.</translate>
<translate>
[[Image:DatePicker1.calendar-en.png|right]]</translate>
<translate>
* '''type''' (mandatory) must be ''calendar''.</translate>
<translate>
* '''name''' (mandatory) is the unique name of the field.</translate>
<translate>
* '''label''' (mandatory) (translatable) is the descriptive title of the field.</translate>
<translate>
* '''default''' (optional) is the default date. This must be given in the same format as specified by the format argument. You can put "NOW" to have current date or time information in the given format.</translate>
<translate>
* '''description''' (optional) (translatable) is text that will be shown as a tooltip when the user moves the mouse over the text box.</translate>
<translate>
* '''readonly''' (optional) is whether the text box is read-only (''true'' or ''false''). If the text box is read-only, the date cannot be changed, but can be selected and copied. No calendar icon will be shown.</translate>
<translate>
* '''disabled''' (optional) is whether the text box is disabled (''true'' or ''false''). If the text box is disabled, the date cannot be changed, selected or copied.</translate>
<translate>
* '''class''' (optional) is a CSS class name for the HTML form field. It is recommended to use the "Bootstrap2 Relatives sizing" (see code examples below).</translate>
<translate>
* '''format''' (optional) is the date format to be used. This is in the format used by PHP to specify date string formats (see below). If no format argument is given, '%Y-%m-%d' is assumed (giving dates like '2017-05-15').</translate>
<translate>
* '''filter''' (optional) is time zone to be used. There are two values; server_utc and user_utc. The first one is server time zone and the later is user time zone as configured in global configuration and user information respectively.</translate>
<translate>

* '''translateformat''' (optional): If set to true, the calendar will use a language string to determine the format. The `format` attribute is ignored. If false, the `format` attribute is used (same behaviour as today). (starting with 3.7.0)</translate>
<translate>

* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)</translate>

<translate>

* '''timeformat''' (optional): can be set to 12 (and specify AM or PM) or 24 (starting with 3.7.0)</translate>

<translate>

* '''singleheader''' (optional): if set to false, the year and the month selection will be set on two separates lines, with independant selection (starting with 3.7.0)</translate>

<translate>

* '''todaybutton''' (optional): if set to true, a button is added at the bottom of the datePicker to select the date of the current day (starting with 3.7.0)</translate>

<translate>

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)</translate>

<translate>

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current month to fill the grid (starting with 3.7.0)</translate>

<translate>

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)</translate>

<translate>

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)</translate>

<translate>
Example for a light DatePicker XML field definition:</translate>
<translate><source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source></translate>
[[Image:DatePicker1.calendar-<translate>
en</translate>.png|center]]

<translate>

Example for an advanced DatePicker XML field definition:</translate>
<translate><source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source></translate>
[[Image:DatePicker2.calendar-<translate>
en</translate>.png|center]]

<translate>
The format attribute specifies the format that the date string will be saved in. It is also the format that manually entered dates need to be enterered in; except that the punctuation character is ignored. The coding scheme used to specify date formats is a custom one defined for the javascript library used in the datepicker, full details of which can be found for example on [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 Joomla's Github].</translate>
<translate>
The following are some of the most frequently used date string codes:</translate>

{| class="wikitable"
|-
!<translate>
Character</translate>
!<translate>
Description</translate>
!<translate>
Example</translate>
|-
|d
|<translate>
Day of the month, 2 digits with leading zeros</translate>
|<translate>
01 to 31</translate>
|-
|a
|<translate>
A textual representation of a day, three letters</translate>
|<translate>
Mon through Sun</translate>
|-
|e
|<translate>
Day of the month without leading zeros</translate>
|<translate>
1 to 31</translate>
|-
|A
|<translate>
A full textual representation of the day of the week</translate>
|<translate>
Monday through Sunday</translate>
|-
|w
|<translate>
Numeric representation of the day of the week</translate>
|<translate>
0 (for Sunday) through 6 (for Saturday)</translate>
|-
|j
|<translate>
The day of the year (starting from 0)</translate>
|<translate>
001 through 366</translate>
|-
|B
|<translate>
A full textual representation of a month</translate>
|<translate>
January through December</translate>
|-
|m
|<translate>
Numeric representation of a month, with leading zeros</translate>
|<translate>
01 through 12</translate>
|-
|b
|<translate>
A short textual representation of a month, three letters</translate>
|<translate>
Jan through Dec</translate>
|-
|Y
|<translate>
A full numeric representation of a year, 4 digits</translate>
|<translate>
1999 or 2003</translate>
|-
|y
|<translate>
A two-digit representation of a year</translate>
|<translate>
99 or 03</translate>
|-
|p
|<translate>
Lowercase Ante Meridiem or Post Meridiem</translate>
|<translate>
am or pm</translate>
|-
|P
|<translate>
Uppercase Ante Meridiem or Post Meridiem</translate>
|<translate>
AM or PM</translate>
|}

<translate>
Note: The format in which dates are stored in the params.ini file is that specified by the format argument. Since there can be language-dependent elements to this format (for example, the '%A' specifier), you need to be careful not to use such elements if there is a possibility that the front-end and back-end languages may be different.</translate>

<translate>
Note: The calendar form field type does not support non-Gregorian calendars. If you need to support non-Gregorian calendars then you will need to create a custom form field type to support your calendar.</translate>

<translate>=== Standard associated filters === </translate>
<translate>
* '''user_utc''' - Calculates the specified value to the time of Greenwich, according to the user time zone settings.</translate>

<translate>=== See also === </translate>
<translate>
* [[S:MyLanguage/Standard form field types|List of standard form field types]]</translate>

<noinclude>
<translate>

[[Category:Standard form field types]]
</translate>
</noinclude>

Calendar form field type/fr

2017-05-18T10:45:31Z

Garstud: Created page with "* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <co..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/52/fr

2017-05-18T10:45:30Z

* '''showtime''' (facultatif):est un argument booléen. Si la valeur est 'true' et que <code>translateformat</code> a aussi la valeur 'true' , La clé de chaine de langue <code>DATE_FORMAT_CALENDAR_DATETIME</code> est utilisée, sinon <code>DATE_FORMAT_CALENDAR_DATE</code> sera utilisé. (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:41:00Z

Garstud: Created page with "fr"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-fr.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/63/fr

2017-05-18T10:41:00Z

Garstud: Created page with "fr"

Calendar form field type/fr

2017-05-18T10:40:59Z

Garstud: Created page with "Exemple de définition de champ XML pour un sélecteur de date avancé :"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Exemple de définition de champ XML pour un sélecteur de date avancé :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/62/fr

2017-05-18T10:40:59Z

Garstud: Created page with "Exemple de définition de champ XML pour un sélecteur de date avancé :"

Exemple de définition de champ XML pour un sélecteur de date avancé :

Calendar form field type/fr

2017-05-18T10:40:14Z

Garstud: Created page with "fr"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-fr.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/61/fr

2017-05-18T10:40:13Z

Garstud: Created page with "fr"

Calendar form field type/fr

2017-05-18T10:40:03Z

Garstud:

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Exemple de définition de champ XML pour un sélecteur de date simplifié :
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/12/fr

2017-05-18T10:40:03Z

Garstud:

Exemple de définition de champ XML pour un sélecteur de date simplifié :

Calendar form field type/fr

2017-05-18T10:39:28Z

Garstud: Created page with "* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite max..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/60/fr

2017-05-18T10:39:28Z

* '''maxyear''' (année maximum) (facultatif): saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite maximum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année supérieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:38:47Z

Garstud: Created page with "* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite mi..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/59/fr

2017-05-18T10:38:47Z

* '''minyear''' (année minimum) (facultatif) : saisir un numéro avec un signe comme nombre d'années (-10, -2, 0, 7, 12, ...) pour définir le nombre relatif de la limite minimum de choix de l'année. L'utilisateur ne pourra pas sélectionner une année inférieure à votre limite (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:34:38Z

Garstud: Created page with "* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/58/fr

2017-05-18T10:34:38Z

* '''filltable''' (remplir la grille) (facultatif) est un argument booléen. Si la valeur est 'true', les dates du mois précédent et suivant seront affichées grisées, mais sélectionnables, pour compléter les espaces libres de la grille du mois (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:32:26Z

Garstud: Created page with "* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/57/fr

2017-05-18T10:32:26Z

* '''weeknumbers''' (numéro de semaine) (facultatif) est un argument booléen. Si la valeur est 'true', une colonne est ajoutée à gauche du sélecteur de date pour afficher le numéro de la semaine dans l'année courante (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:30:26Z

Garstud: Created page with "* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/56/fr

2017-05-18T10:30:26Z

* '''todaybutton''' (bouton aujourd'hui) (facultatif) est un argument booléen. Si la valeur est 'true', un bouton est affiché en bas du sélecteur de date pour permettre de sélectionner rapidement la date du jour courant (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:28:13Z

Garstud: Created page with "* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparée..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom pof the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/55/fr

2017-05-18T10:28:12Z

* '''singleheader''' (Entête unique) (facultatif) est un argument booléen. Si la valeur est 'false', la sélection de l'année et du mois s'effectuera sur 2 lignes séparées, avec une sélection indépendante (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:25:21Z

Garstud: Created page with "* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

* '''singleheader''' (optional): if set to false, the year and the moth selection will be set on two separates lines, with independant selection (starting with 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom pof the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/54/fr

2017-05-18T10:25:20Z

Garstud: Created page with "* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)"

* '''timeformat''' (format de l'heure) (facultatif): peut être réglé sur 12 (en précisant AM ou PM) ou 24 heures (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:23:06Z

Garstud: Created page with "* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour d..."

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (optional): can be set to 12 (and spcify AM or PM) or 24 (starting with 3.7.0)

* '''singleheader''' (optional): if set to false, the year and the moth selection will be set on two separates lines, with independant selection (starting with 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom pof the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/51/fr

2017-05-18T10:23:05Z

* '''translateformat''' (format auto-traduit) (facultatif) est un argument booléen. Si la valeur est 'true', le calendrier utilisera une chaine de langue pré-définie pour définir le format de date dans la langue de l'utilisateur. L'attribut 'format est, dans ce cas, ignoré. Si la valeur est 'false', c'est l'attribut 'format' qui définie le format de la date (comportement identique à celui actuellement) (nouvel attribut à partir de Joomla 3.7.0)

Calendar form field type/fr

2017-05-18T10:15:21Z

Garstud:

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (optional): If set to true, the calendar will use a language string to determine the format. The `format` attribute is ignored. If false, the `format` attribute is used (same behaviour as today). (starting with 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (optional): can be set to 12 (and spcify AM or PM) or 24 (starting with 3.7.0)

* '''singleheader''' (optional): if set to false, the year and the moth selection will be set on two separates lines, with independant selection (starting with 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom pof the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/10/fr

2017-05-18T10:15:21Z

Garstud:

* '''format''' (facultatif) est le format de date à utiliser. C'est par le format utilisé par PHP qu'il convient de spécifier le format de chaîne de la date (voir ci-dessous). Si aucun argument de format n'est renseigné, '%Y-%m-%d' (donnant ainsi des dates de type : '2017-05-15').

Calendar form field type/fr

2017-05-18T10:15:10Z

Garstud:

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)
* '''format''' (optional) is the date format to be used. This is in the format used by PHP to specify date string formats (see below). If no format argument is given, '%Y-%m-%d' is assumed (giving dates like '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (optional): If set to true, the calendar will use a language string to determine the format. The `format` attribute is ignored. If false, the `format` attribute is used (same behaviour as today). (starting with 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (optional): can be set to 12 (and spcify AM or PM) or 24 (starting with 3.7.0)

* '''singleheader''' (optional): if set to false, the year and the moth selection will be set on two separates lines, with independant selection (starting with 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom pof the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>

Translations:Calendar form field type/9/fr

2017-05-18T10:15:09Z

Garstud:

* '''class''' (classe) (facultatif) est le nom de la classe CSS du champ de formulaire HTML. I est recommandé d'utiliser les "Bootstrap2 Relatives sizing" (voir les codes d'exemples XML ci-dessous)

Calendar form field type/fr

2017-05-18T10:13:18Z

Garstud: Created page with "right"

<noinclude><languages /></noinclude>
Le type de champ de formulaire '''calendar''' fournit une zone de texte pour la saisie d'une date. Une icône à côté de la zone de texte propose un lien vers un calendrier en pop-up qui peut également être utilisé pour entrer la valeur de la date. Si le champ a une valeur enregistrée, elle sera affichée dans la zone de texte. Sinon, la valeur par défaut est affichée.
[[Image:DatePicker1.calendar-fr.png|right]]
* '''type''' (obligatoire) doit être "calendar".
* '''name''' (nom) (obligatoire) est le nom unique du champ.
* '''label''' (étiquette) (obligatoire) (traduisible) est le titre descriptif du champ.
* '''default''' (par défaut) (facultatif) est la date par défaut. Elle doit être définie dans le même format que celui spécifié par l'argument de format. Vous pouvez renseigner "NOW" pour afficher les informations de date ou d'heure actuelle dans le format donné.
* '''description''' (facultatif) (traduisible) est le texte qui s'affichera dans une info-bulle lorsque l'utilisateur passe sa souris sur la zone de texte.
* '''readonly''' (lecture seule) (facultatif) pour définir la zone de texte est en lecture seule ("true" ou "false"). Si la zone de texte est en lecture seule, la date ne peut pas être changée, mais peut être sélectionnée et copiée. Aucune icône de calendrier sera affichée.
* '''disabled''' (désactivé) (facultatif) pour que la zone de texte soit ou non désactivée ("true" ou "false"). Si la zone de texte est désactivée, la date ne pourra pas être modifiée ou copiée.
* '''class''' (optional) is a CSS class name for the HTML form field. It is recommended to use the "Bootstrap2 Relatives sizing" (see code examples below).
* '''format''' (optional) is the date format to be used. This is in the format used by PHP to specify date string formats (see below). If no format argument is given, '%Y-%m-%d' is assumed (giving dates like '2017-05-15').
* '''filter''' (filtre) (facultatif) est le fuseau horaire à utiliser. Il y a deux valeurs : server_utc et user_utc. La première est le fuseau horaire du serveur et la seconde est le fuseau horaire de l'utilisateur tel que défini respectivement dans la configuration générale et dans les informations utilisateurs.
* '''translateformat''' (optional): If set to true, the calendar will use a language string to determine the format. The `format` attribute is ignored. If false, the `format` attribute is used (same behaviour as today). (starting with 3.7.0)
* '''showtime''' (optional): If set to true and <code>translateformat</code> is true, the language key <code>DATE_FORMAT_CALENDAR_DATETIME</code> is used, otherwise <code>DATE_FORMAT_CALENDAR_DATE</code>. (starting with 3.7.0)

* '''timeformat''' (optional): can be set to 12 (and spcify AM or PM) or 24 (starting with 3.7.0)

* '''singleheader''' (optional): if set to false, the year and the moth selection will be set on two separates lines, with independant selection (starting with 3.7.0)

* '''todaybutton''' (optional): if set to true, a button is added at the bottom pof the datePicker to select the date of the current day (starting with 3.7.0)

* '''weeknumbers''' (optional): if set to true, a column is added at the left of the datePicker to display the number of the week in the current year (starting with 3.7.0)

* '''filltable''' (optional): if set to true, dates of the previous and next month is added at the top and the bottom of the current mont to fill the grid (starting with 3.7.0)

* '''minyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user could not select a year before your limit (starting with 3.7.0)

* '''maxyear''' (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user could not select a year after your limit (starting with 3.7.0)

Example for a light DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" /></source>
[[Image:DatePicker1.calendar-en.png|center]]

Example for an advanced DatePicker XML field definition:
<source lang="xml"><field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description="" type="calendar"
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" /></source>
[[Image:DatePicker2.calendar-en.png|center]]

L'attribut format permet de spécifier le format de la chaîne de date qui sera enregistré. C'est aussi le format de saisie manuelle devant être utilisé ; sauf que le caractère de ponctuation sera ignoré. Le système de codage utilisé pour spécifier les formats de date est personnalisé pour la bibliothèque javascript utilisé dans 'datepicker'. De nombreux détails concernant les formats peuvent être consultés par exemple sur : [https://github.com/joomla/joomla-cms/blob/staging/media/system/js/calendar-uncompressed.js#L1741-L1774 GitHub Joomla!].
Les éléments suivants sont les chaînes de code date les plus fréquemment utilisées :

{| class="wikitable"
|-
!Caractère
!Description
!Exemple
|-
|d
|Jour du mois, avec 2 chiffres et les zéros
|De 01 à 31
|-
|a
|Une représentation textuelle du jour, en trois lettres
|De Lun à Dim
|-
|e
|Jour du mois sans zéros en début
|De 1 à 31
|-
|A
|Une représentation textuelle du jour de la semaine
|De Lundi à Dimanche
|-
|w
|Représentation numérique du jour de la semaine
|0 (pour Dimanche) à 6 (pour Samedi)
|-
|j
|Le jour de l'année (à partir de 0)
|De 001 à 366
|-
|B
|Une représentation textuelle du mois
|De janvier à décembre
|-
|m
|Représentation numérique d'un mois, avec les zéros
|De 01 à 12
|-
|b
|Une représentation textuelle du mois, en trois lettres
|De jan à déc
|-
|Y
|Représentation numérique d'une année, en 4 chiffres
|1999 ou 2003
|-
|y
|Représentation numérique d'une année en deux chiffres
|99 ou 03
|-
|p
|Ante Meridiem ou Post Meridiem en minuscules
|am ou pm
|-
|P
|Ante Meridiem ou Post Meridiem en majuscules
|AM ou PM
|}

Remarque : le format dans lequel les dates sont stockées dans les le fichier <tt>params.ini</tt> est celui spécifié par l'argument de format. Puisqu'il peut exister des dépendances d'éléments de langue pour ce format (par exemple le spécificateur '%A'), vous devez être prudent et ne pas utiliser ces éléments si il existe une possibilité que les langues utilisées en frontend et backend soient différentes.

Remarque : le type de champ de formulaire calendar ne prend pas en charge les types de calendriers non-Grégoriens. Si vous avez besoin d'un tel type de calendrier, vous aurez alors besoin de créer un nouveau type de champ de formulaire en soutien de votre calendrier.

=== Filtres associés standards ===
* '''user_utc''' - calcule la valeur spécifiée à l'heure de Greenwich, en fonction des paramètres de fuseau horaire de l'utilisateur.

===Voir également===
* [[S:MyLanguage/Standard form field types|Liste des types de champ de formulaires standards]]

<noinclude>
[[Category:Standard form field types/fr|Types de champ de formulaire standard]]
</noinclude>