Fonction TIMEZONE

TIMEZONE renvoie un horodatage pour la valeur du fuseau horaire et de l’horodatage spécifiée.

Pour plus d’informations et d’exemples sur la façon de définir un fuseau horaire, consultez timezone.

Pour plus d’informations et d’exemples sur la façon de convertir un fuseau horaire, consultez CONVERT_TIMEZONE.

Syntaxe

TIMEZONE('timezone', { timestamp | timestamptz })

Arguments

timezone

Le fuseau horaire de la valeur de retour. Le fuseau horaire peut être spécifié comme nom de fuseau horaire (tel que 'Africa/Kampala' ou 'Singapore') ou comme abréviation de fuseau horaire (telle que 'UTC' ou 'PDT'). Pour afficher la liste des noms de fuseaux horaires pris en charge, exécutez la commande suivante.

select pg_timezone_names();

Pour afficher la liste des abréviations de fuseaux horaires prises en charge, exécutez la commande suivante.

select pg_timezone_abbrevs();

Pour plus d’informations et d’exemples, consultez Remarques sur l’utilisation de fuseaux horaires.

timestamp | timestamptz

Expression qui a pour résultat un type TIMESTAMP ou TIMESTAMPTZ, ou une valeur qui peut être implicitement convertie en horodatage ou horodatage avec fuseau horaire.

Type de retour

TIMESTAMPTZ lorsqu’il est utilisé avec une expression TIMESTAMP.

TIMESTAMP lorsqu’il est utilisé avec une expression TIMESTAMPTZ.

Exemples

L’exemple suivant renvoie un horodatage pour le fuseau horaire UTC en utilisant l’horodatage 2008-06-17 09:44:54 du fuseau horaire PST.

SELECT TIMEZONE('PST', '2008-06-17 09:44:54');

timezone
-----------------------
2008-06-17 17:44:54+00

L’exemple suivant renvoie un horodatage pour le fuseau horaire PST en utilisant l’horodatage avec le fuseau horaire UTC 2008-06-17 09:44:54+00.

SELECT TIMEZONE('PST', timestamptz('2008-06-17 09:44:54+00'));

timezone
-----------------------
2008-06-17 01:44:54