Table des matières

Search

  1. Préface
  2. Le langage de transformation
  3. Constantes
  4. Opérateurs
  5. Variables
  6. Dates
  7. Fonctions

Référence du langage de transformation

Référence du langage de transformation

TO_TIMESTAMP_TZ

TO_TIMESTAMP_TZ

Convertit une chaîne en horodatage avec valeur de fuseau horaire. La fonction renvoie Horodatage dont le type de données est Fuseau horaire. Utilisez des chaînes de format TO_TIMESTAMP_TZ pour spécifier le format des chaînes sources.

Syntaxe

TO_TIMESTAMP_TZ (
String
, [
format
] )
Le tableau suivant décrit les arguments de cette commande:
Argument
Requis/
Facultatif
Description
Chaîne
Requis
Doit être un type de données de chaîne. Transmet les valeurs que vous souhaitez convertir en Horodatage avec fuseau horaire. Vous pouvez entrer l'expression de transformation valide de votre choix.
Il doit s'agir d'une chaîne de caractères.
format
Facultatif
Entrez une chaîne de format TO_TIMESTAMP_TZ valide. La chaîne de format doit correspondre aux parties de l'argument chaîne. Par exemple, si vous transmettez la chaîne « Mar 15 1997 12:43:10AM ASIA/CALCUTTA », vous devez utiliser la chaîne de format « MON DD YYYY HH12:MI:SSAM TZR ».
Si vous ne spécifiez pas la chaîne de format, la fonction utilise le format date/heure par défaut dans la boîte de dialogue Exécuter les configurations.

Valeur de retour

Renvoie un Horodatage dont le type de données est Fuseau horaire.
NULL si l'entrée est une valeur Null.
Si la valeur transmise à la fonction contient des données qui ne sont pas valides pour une valeur Horodatage avec fuseau horaire, le service d'intégration de données marque la ligne comme une ligne d'erreur ou fait échouer le mappage.
Exemple
INPUT VALUE
RETURN VALUE
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM TZR'
Renvoie un type de données Horodatage avec fuseau horaire avec les données suivantes :
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES’
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM'
Renvoie un type de données Horodatage avec fuseau horaire même sans spécifier la région du fuseau horaire dans le format de région de fuseau horaire :
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’
Renvoie un type de données Horodatage avec fuseau horaire même sans spécifier le format Horodatage avec fuseau horaire.
'1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
Le format de date/heure par défaut de la boîte de dialogue Exécuter les configurations est utilisé lorsque le format n'est pas spécifié au niveau de la fonction.
Format de date/heure par défaut :
« YYYY-MM-DD HH:MI:SS.NS AM TZR »
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, ’MM-DD-YYYY HH:MI:SS.NS AM'
Si un type de données Horodatage avec fuseau horaire ne correspond pas au format donné, l'erreur suivante s'affiche :
Process row failed for function [TO_TIMESTAMP_TZ]: Failed to convert the string to timestamp with time zone value. Verify that the specified date format string is valid. Verify that the timestamp with time zone string used in the first argument is compatible with the specified date format.