Documentation PostgreSQL 9.1.24 > Annexes > Support de date/heure > Fichiers de configuration date/heure | |
Mots clés Date/Heure | Histoire des unités |
Comme il n'existe pas de réel standard des abréviations de fuseaux horaire, PostgreSQL™ permet de personnaliser l'ensemble des abréviations acceptées par le serveur. Le paramètre d'exécution timezone_abbreviations détermine l'ensemble des abréviations actives. Bien que tout utilisateur de la base puisse modifier ce paramètre, les valeurs possibles sont sous le contrôle de l'administrateur de bases de données -- ce sont en fait les noms des fichiers de configuration stockés dans .../share/timezonesets/ du répertoire d'installation. En ajoutant ou en modifiant les fichiers de ce répertoire, l'administrateur peut définir les règles d'abréviation des fuseaux horaires.
timezone_abbreviations peut prendre tout nom de fichier situé dans .../share/timezonesets/, sous réserve que ce nom soit purement alphabétique. (L'interdiction de caractères non alphabétique dans timezone_abbreviations empêche la lecture de fichiers en dehors du répertoire prévu et celle de fichiers de sauvegarde ou autre.)
Un fichier d'abréviation de zones horaires peut contenir des lignes blanches et des commentaires (commençant avec un #). Les autres lignes doivent suivre l'un des formats suivants :
abréviation_zone décalage abréviation_zone décalage D abréviation_zone nom_fuseau_horaire @INCLUDE nom_fichier @OVERRIDE
Un abréviation_zone n'est que l'abréviation en cours de définition. Un décalage est un entier correspondant au décalage équivalent en secondes à partir d'UTC, un nombre positif correspondant à l'est de Greenwich, et un nombre négatif l'ouest. Par exemple, -18000 serait cinq heures à l'ouest de Greenwich, autrement dit le fuseau horaire de la côté est de l'Amérique du Nord. D indique que le nom du fuseau horaire représente un changement d'horaire par rapport à l'heure normale.
Autrement, un nom_fuseau_horaire peut être donné référençant un fuseau horaire défini dans la base de données IANA des fuseaux horaires. La définition de zone est consultée pour vérifier si l'abréviation est ou a été utilisé dans cette zone et, si c'est le cas, la signification appropriée à utiliser -- autrement dit, la signification en cours au moment de l'horodatage dont la valeur est en cours de détermination, ou la signification précédant immédiatement, ou la signification la plus ancienne si elle n'a été utilisée qu'après cet horodatage. Ce comportement est essentiel pour garer les abréviations dont la signification a varié dans le temps. Il est aussi permis de définir une abréviation en terme de nom de fuseau horaire dans lequel cet abréviation n'apparaît pas. Dans ce cas, utiliser l'abréviation est équivalent à écrire le nom du fuseau horaire.
Utiliser un seul entier décalage est préféré lors de la définition d'une abréviation dont le décalage d'UTC n'a jamais changé car ce type d'abréviation est bien moins coûteuse à traiter que celles qui nécessite de consulter une définition des fuseaux horaires.
La syntaxe @INCLUDE autorise l'inclusion d'autres fichiers du répertoire .../share/timezonesets/. Les inclusions peuvent être imbriquées jusqu'à une certaine profondeur.
La syntaxe @OVERRIDE indique que les entrées suivantes du fichier peuvent surcharger les entrées précédentes (c'est-à-dire des entrées obtenues à partir de fichiers inclus). Sans cela, les définitions en conflit au sein d'une même abréviation lèvent une erreur.
Dans une installation non modifiée, le fichier Default contient toutes les abréviations de fuseaux horaire, sans conflit, pour la quasi-totalité du monde. Les fichiers supplémentaires Australia et India sont fournis pour ces régions : ces fichiers incluent le fichier Default puis ajoutent ou modifient les abréviations si nécessaire.
Pour des raisons de référence, une installation standard contient aussi des fichiers Africa.txt, America.txt, etc. qui contiennent des informations sur les abréviations connues et utilisées en accord avec la base de données de fuseaux horaires IANA. Les définitions des noms de zone trouvées dans ces fichiers peuvent être copiées et collées dans un fichier de configuration personnalisé si nécessaire. Il ne peut pas être fait directement référence à ces fichiers dans le paramètre timezone_abbreviations à cause du point dans leur nom.
Si une erreur survient lors de la lecture de l'ensemble des abréviations, aucune nouvelle valeur n'est acceptée mais les anciennes sont conservées. Si l'erreur survient au démarrage de la base, celui-ci échoue.
Les abréviations de fuseau horaire définies dans le fichier de configuration surchargent les informations sans fuseau définies nativement dans PostgreSQL™. Par exemple, le fichier de configuration Australia définit SAT (South Australian Standard Time, soit l'heure standard pour l'Australie du sud). Si ce fichier est actif, SAT n'est plus reconnu comme abréviation de samedi (Saturday).
Si les fichiers de .../share/timezonesets/ sont modifiés, il revient à l'utilisateur de procéder à leur sauvegarde -- une sauvegarde normale de base n'inclut pas ce répertoire.