Travailler avec les fuseaux horaires

Analyse de séries chronologiques dans PostgreSQL

Jasmin Ludolf

Content Developer, DataCamp

Données de fuseau horaire

TIMESTAMP : date et heure sans fuseau horaire
- Suffisant si un seul fuseau
- Toutes les heures sont en UTC
TIMESTAMPTZ : date et heure avec fuseau horaire

Illustration de quatre horloges indiquant des heures différentes.

Noms des fuseaux horaires

SELECT * FROM pg_timezone_names;

| name             |abbrev|utc_offset|is_dst|
|------------------|------|----------|------|
|Africa/Abidjan    |GMT   |  00:00:00|false |
|Africa/Accra      |GMT   |  00:00:00|false |
|Africa/Addis_Ababa|EAT   |   3:00:00|false |
...

is_dst : indique si l'emplacement applique l'heure avancée

Afficher le fuseau horaire

SHOW TIMEZONE;

|TimeZone       |
|---------------|
|Europe/Brussels|

Données de fuseau horaire dans les tables

La table datetimes contient deux champs :
- datetime : TIMESTAMP
- datetimetz : TIMESTAMPTZ

INSERT INTO datetimes (datetime, datetimetz)
VALUES('2023-01-03 12:00:00','2023-01-03 12:00:00');

|datetime           |datetimetz               |
|-------------------|-------------------------|
|2023-01-03 12:00:00|2023-01-03 12:00:00+01:00|

Vérifier le type de données

pg_typeof(field_name) : vérifier le type du champ

SELECT
    pg_typeof(datetime) AS "type of(datetime)", 
    pg_typeof(datetimetz) AS "type of(datetimetz)"
FROM datetimes;

|type of(datetime)          |type of(datetimetz)     |
|---------------------------|------------------------|
|timestamp without time zone|timestamp with time zone|

Utiliser l'information de fuseau horaire

INSERT INTO datetimes (datetime, datetimetz)
VALUES('2023-01-03 12:00:00+00','2023-01-03 12:00:00+00');

SELECT * FROM datetimes;

|datetime           |datetimetz               |
|-------------------|-------------------------|
|2023-01-03 12:00:00|2023-01-03 12:00:00+01:00|
|2023-01-03 12:00:00|2023-01-03 13:00:00+01:00|

Ajouter un fuseau horaire

AT TIME ZONE : ajouter, changer ou retirer l'info de fuseau
- Conversion entre TIMESTAMP et TIMESTAMPTZ et inversement

Ajouter un fuseau horaire :

SELECT 
    TIMESTAMP '2020-12-31 23:59:59' AT TIME ZONE 'Europe/London' AS added;

|added                    |
|-------------------------|
|2021-01-01 00:59:59+01:00|

Cette requête : interprète l'horodatage, crée TIMESTAMPTZ, affiche le défaut

Modifier et retirer des fuseaux horaires

SELECT 
    '2020-12-31 23:59:59+00'::TIMESTAMPTZ AT TIME ZONE 'Europe/Paris' 
    AS shifted;

|shifted            |
|-------------------|
|2021-01-01 00:59:59|

Cette requête : décale l'horodatage vers le fuseau voulu, retire l'indication de fuseau

Passons à la pratique !

Analyse de séries chronologiques dans PostgreSQL