Outils pour utilisateurs

Outils du site


Panneau latéral

ref:phptal:formattage

Formatage

Dates : date: et datetime:

date:

Existe à partir de la version 3.5.0. Pour les versions antérieures, utiliser change:date.

Ce mot-clé permet de formater une date. Il accepte jusqu'à trois paramètres séparés par des virgules :

  • la date à formater dans le fuseau horaire local et au format SQL YYYY-MM-DD HH:MM:SS
  • le format à utiliser comme supporté par la fonction date()
  • le paramètre from=gmt pour qu'une conversion dans le fuseau horaire local soit faite (à partir de la version 3.6.0)

Remarques :

  • si aucun paramètre n'est transmis, la date courante est rendue
  • un getter getUIXxx est automatiquement généré sur les documents pour chaque propriété de type DateTime et renvoie la date au bon format et pour le bon fuseau horaire
  • afin d'assurer la cohérence globale du site, il est recommandé d'utiliser prioritairement le format par défaut
  • le format par défaut est localisé, la clé correspondante est f.date.date.default-date-format
  • pour ajouter les heures et minutes, passer par datetime: plutôt que par un format différent

Exemples :

<!-- Date courante au format par défaut. -->
${date:}
<!-- Date par défaut du document mydoc au format par défaut. -->
${date:mydoc/getUICreationdate}
<!-- Date par défaut du document mydoc au format 'd/m/Y'. -->
${date:mydoc/getUICreationdate,'d/m/Y'}

datetime:

Existe à partir de la version 3.5.0. Pour les versions antérieures, utiliser change:datetime

Ce mot-clé fonctionne comme date: à ceci près que son format par défaut inclut les heures et minutes. La clé correspondante est f.date.date.default-datetime-format.

Exemples :

<!-- Date/heure courante au format par défaut. -->
${datetime:}
<!-- Date/heure par défaut du document mydoc au format par défaut. -->
${datetime:mydoc/getUICreationdate}
<!-- Date/heure par défaut du document mydoc au format 'd/m/Y'. -->
${datetime:mydoc/getUICreationdate,'d/m/Y'}

change:date

Déprécié à partir de la version 3.5.0. Remplacé par le mot-clé date:

change:date permet le formattage des données de type Date. Le paramètre value étant une chaîne de caractères “date GMT” au format SQL YYYY-MM-DD HH:MM:SS qui sera convertie à la date utilisateur.

Utilisation simple (format par défaut) :

<span change:date="value mydoc/getCreationdate" />

Spécification du format, comme supporté par la fonction date() :

<span change:date="format 'd/m/Y'; value mydoc/getCreationdate" />

Spécification du format en utilisant une locale :

<span change:date="formatI18n framework.date.short; value mydoc/getCreationdate" />

change:datetime

Déprécié à partir de la version 3.5.0. Remplacé par le mot-clé datetime:

change:datetime agit comme change:date à ceci prêt que le format par défaut préserve l'heure et les minutes.

Prix : change:price

change:price permet le formattage de prix : il formate le paramètre value avec deux chiffres après la virgule.

Si le paramètre currency est défini, sa valeur est ajoutée à gauche ou à droite du prix selon le paramètre currencyPosition (valant alors “left” ou “right” ; “right” par défaut).

<span change:price="value 10.23586; currency '€'; currencyPosition 'left'" />
<span change:price="value mydoc/getPrice; currency myprefs/getCurrency; currencyPosition myprefs/getCurrencyPosition" />
ref/phptal/formattage.txt · Dernière modification: 2017/01/19 14:54 (modification externe)