4.5.6 Date au format ISO

La version 3.1 préconisait le stockage de date au format ISO (paramétrage du datestyle en BDD).

Le format ISO pour les dates est rendu obligatoire à partir de la version 3.2.

4.5.6.1 Format interne et manipulation des dates

Les dates sont stockées au format ISO complete date : YYYY-MM-DD1.

La manipulation des dates, lecture et écriture des valeurs d'attributs, est faite par les méthodes Doc::getRawValue() et Doc::setValue() :

  • Doc::getRawValue() retourne la valeur brute des attributs, la valeur de la date au format ISO dans notre cas.
  • Doc::setValue() accepte une date au format ISO ou bien une date formatée selon la locale de l'utilisateur2. La méthode réalise si nécessaire la conversion avant de stocker la date.

4.5.6.2 Importation des familles

Les déclarations de familles (CSV ou ODS) doivent obligatoirement contenir des dates au format ISO (valeurs par défaut, paramètres, etc.).

4.5.6.3 Importation de documents

Les valeurs des attributs de type date sont notés au format ISO.

Bien que le format ISO soient fortement recommandé, il reste possible d'importer des documents pour lesquels les dates sont fournies dans le format de la locale de l'utilisateur réalisant l'import.

  1. par exemple, 2013-04-29 pour le 29 avril 2013 ↩

  2. Cette locale doit être déclarée et paramétrée via le fichier lang.php ↩

Source : developper-corner/param/Date_ISO.md Dynacase Platform 3.2 | Dynacase Platform Release note, version 3.2 édition 2019.05.22, © Anakeen Labs <labs@anakeen.com>
×
Publié sous licence CC (http://creativecommons.org/licenses/by-nc-sa/2.0/fr/) par Anakeen [www.anakeen.com]
Attribution Vous devez créditer l'Oeuvre, intégrer un lien vers la licence et indiquer si des modifications ont été effectuées à l'Oeuvre. Vous devez indiquer ces informations par tous les moyens possibles mais vous ne pouvez pas suggérer que l'Offrant vous soutient ou soutient la façon dont vous avez utilisé son Oeuvre.
Pas d’Utilisation Commerciale Vous n'êtes pas autoriser à faire un usage commercial de cette Oeuvre, tout ou partie du matériel la composant.
Partage dans les Mêmes Conditions Dans le cas où vous effectuez un remix, que vous transformez, ou créez à partir du matériel composant l'Oeuvre originale, vous devez diffuser l'Oeuvre modifiée dans les même conditions, c'est à dire avec la même licence avec laquelle l'Oeuvre originale a été diffusée.