Langages et normes: Difference between revisions

Jump to navigation Jump to search
m
Line 121: Line 121:
=== Les dates et TimeZone ===
=== Les dates et TimeZone ===
Dolibarr se veut une application mutli-utilisateur et multi-localisation. Il convient donc de stocker les dates dans le bon format. Pour éviter les problèmes de conversion, les règles suivantes doivent être appliquées:
Dolibarr se veut une application mutli-utilisateur et multi-localisation. Il convient donc de stocker les dates dans le bon format. Pour éviter les problèmes de conversion, les règles suivantes doivent être appliquées:
* Une date en mémoire doit être au format Timestamp et en heure GMT.
* Une date en mémoire doit être au format Timestamp GMT.
* Une date stockée en base de donnée contient la date en heure locale <b>du serveur PHP</b>.
* Une date stockée en base de donnée contient le Timestamp GMT en rapport avec la date soumise dans la requête en heure locale <b>du serveur PHP</b>. Cela ne concerne pas les dates mises à jour automatiquement par la base (champ '''tms''' en base).
Ainsi le 1er janvier 1970, 2 heures à Paris sera stocké en mémoire avec la valeur 3600 et
Ainsi le 1er janvier 1970, 2 heures à Paris (TZ=+1) sera stocké en mémoire sera soumis à la base de données avec la chaine '19700101020000' (PHP convertit en heure de son TZ et la base déconvertit avec son TZ qui est le même que celui de PHP).
dans la base de données avec la valeure '19700101020000'.


Les méthodes select doivent donc traduire les champ dates lu par appel de la méthode db->jdate pour stocker l'information en mémoire et les méthode insert doivent lors de la génération de la requête convertir la date mémoire reçu par la méthode db->idate (Voir exemple généré par le squelette).
Les méthodes select doivent donc traduire les champs dates lus qui sont au format chaine TZ de la base ('19700101020000') par appel de la méthode db->jdate afin de récupérer une information en mémoire au format Timestamp GMT. Et les méthode insert doivent lors de la génération de la requête convertir la date mémoire connue en variable, par la méthode db->idate (Voir exemples générés par le squelette).
 
* Les dates mises à jour automatiquement par la base (champ '''tms''' en base) contiennent le Timestamp GMT au moment ou la modification est faite. Les méthodes select récupèrent directement cette donnée en mémoire au format Timestamp GMT.


=== L'encodage UTF8/ISO ===
=== L'encodage UTF8/ISO ===

Navigation menu