SnowConvert : références des fonctions - Partagées¶

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour multiplier un intervalle de temps par une valeur de “N” fois.

INTERVAL_MULTIPLY_UDF
(INPUT_PART VARCHAR(30), INPUT_VALUE VARCHAR(), INPUT_MULT INTEGER)

Paramètres¶

INPUT_PART VARCHAR

Le format de l’opération. Par exemple : DAY, HOURTOSECOND,``YEARTOMONTH.

INPUT_VALUE VARCHAR

L’intervalle de temps à multiplier.

INPUT_MULT INTEGER

Le temps pour multiplier l’intervalle de temps.

Renvoie¶

Renvoie un varchar contenant le résultat de la multiplication.

Exemple d’utilisation¶

Entrée :

SELECT INTERVAL_MULTIPLY_UDF('DAY', '2', 100);

Sortie :

200

Définition¶

Cette fonction définie par l’utilisateur (UDF) reproduit la fonctionnalité Teradata et Oracle TRUNC(Date) lorsque le paramètre format est spécifié.

TRUNC_UDF(DATE_TO_TRUNC TIMESTAMP_LTZ, DATE_FMT VARCHAR(5))

Paramètres¶

DATE_TO_TRUNC TIMESTAMP_LTZ

Une valeur timestamp_ltz à tronquer qui doit être une date, un horodatage ou un horodatage avec un fuseau horaire.

DATE_FMT VARCHAR

Une valeur varchar qui doit correspondre à l’un des formats de date pris en charge par la fonction trunc.

Renvoie¶

Renvoie une date tronquée selon le format spécifié.

Exemple d’utilisation¶

Entrée :

SELECT TRUNC_UDF(TIMESTAMP '2015-08-18 12:30:00', 'Q')

Sortie :

2015-07-01

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour déterminer la quantité de secondes à partir d’un intervalle qui est également corrélé au type de temps traité. Il s’agit d’une fonction auxiliaire.

INTERVAL_TO_SECONDS_UDF
(INPUT_PART VARCHAR(30), INPUT_VALUE VARCHAR())

Paramètres¶

INPUT_PART VARCHAR

Le type du deuxième paramètre. Par exemple DAY, DAYTOHOUR, HOUR, MINUTE.

INPUT_VALUE VARCHAR

La valeur à convertir en secondes.

Renvoie¶

Renvoie un type de valeur décimale avec le nombre de secondes.

Exemple d’utilisation¶

Entrée :

SELECT INTERVAL_TO_SECONDS_UDF('DAY', '1');

Sortie :

86400.000000

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour générer la différence entre une valeur d’intervalle et une date.

DATEDIFF_UDF(D DATE, INTERVAL_VALUE STRING)

Paramètres¶

D DATE

La date à utiliser pour traiter la différence avec l’intervalle.

INTERVAL_VALUE STRING

La valeur de l’intervalle qui sera utilisée pour créer la différence.

Renvoie¶

Renvoie une date avec la valeur retour de la soustraction du temps.

Exemple d’utilisation¶

Entrée :

SELECT DATEDIFF_UDF('2024-01-30', 'INTERVAL ''2-1'' YEAR(2) TO MONTH');

Sortie :

2021-12-30

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour transformer les secondes en intervalles. Il s’agit d’une fonction auxiliaire.

SECONDS_TO_INTERVAL_UDF
(INPUT_PART VARCHAR(30), INPUT_VALUE NUMBER)

Paramètres¶

INPUT_PART VARCHAR

Le type du deuxième paramètre. Par exemple DAY, DAYTOHOUR, HOUR, MINUTE, MINUTETOSECOND.

INPUT_VALUE VARCHAR

Les secondes à convertir en intervalles.

Renvoie¶

Renvoie

Exemple d’utilisation¶

Entrée :

SELECT SECONDS_TO_INTERVAL_UDF('DAY TO SECOND', '86400');

Sortie :

1 000:000:000

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour ajouter une date à un intervalle de temps.

DATEADD_UDF(INTERVAL_VALUE STRING,D DATE)

Paramètres¶

INTERVAL_VALUE STRING

L’intervalle de temps à ajouter.

D DATE

La date à ajouter à l’intervalle de temps.

Renvoie¶

Renvoie une date avec l’addition de l’intervalle de temps et de la date.

Exemple d’utilisation¶

Entrée :

SELECT DATEADD_UDF('INTERVAL ''2-1'' YEAR(2) TO MONTH', '2024-01-30');

Sortie :

2026-02-28

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour générer la différence entre une valeur d’intervalle et une date.

DATEDIFF_UDF(INTERVAL_VALUE STRING,D DATE)

Paramètres¶

INTERVAL_VALUE STRING

La valeur de l’intervalle qui sera utilisée pour créer la différence.

D DATE

La date à utiliser pour traiter la différence avec l’intervalle.

Renvoie¶

Renvoie une date avec la valeur retour de la soustraction du temps.

Exemple d’utilisation¶

Entrée :

SELECT DATEDIFF_UDF('INTERVAL ''2-1'' YEAR(2) TO MONTH', '2024-01-30');

Sortie :

2021-12-30

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour ajouter une date à un intervalle de temps.

DATEADD_UDF(D DATE, INTERVAL_VALUE STRING)

Paramètres¶

D DATE

La date à ajouter à l’intervalle de temps.

INTERVAL_VALUE STRING

L’intervalle de temps à ajouter.

Renvoie¶

Renvoie une date avec l’addition de l’intervalle de temps et de la date.

Exemple d’utilisation¶

Entrée :

SELECT DATEADD_UDF('2024-01-30', 'INTERVAL ''1-1'' YEAR(2) TO MONTH');

Sortie :

2025-02-28

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour générer un intervalle de temps distinct de l’heure actuelle.

TO_INTERVAL_UDF(D2 TIME)

Paramètres¶

D2 TIME

Le temps d’entrée à convertir en un intervalle séparé.

Renvoie¶

Renvoie une chaîne contenant les informations relatives à l’heure d’entrée séparée.

Exemple d’utilisation¶

Entrée :

SELECT TO_INTERVAL_UDF(CURRENT_TIME);

Sortie :

INTERVAL '4 HOURS,33 MINUTES,33 SECOND'

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour générer un entier avec la quantité d’un mois à partir d’un intervalle. Il s’agit d’une fonction auxiliaire.

INTERVAL_TO_MONTHS_UDF
(INPUT_VALUE VARCHAR())

Paramètres¶

INPUT_VALUE VARCHAR

La valeur de l’intervalle à transformer en mois.

Renvoie¶

Renvoie un entier contenant les informations traitées sur les mois.

Exemple d’utilisation¶

Entrée :

SELECT PUBLIC.INTERVAL_TO_MONTHS_UDF('1-6');

Sortie :

18

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour soustraire un intervalle de temps à un horodatage.

DATEADD_UDF(INTERVAL_VALUE STRING,D TIMESTAMP)

Paramètres¶

INTERVAL_VALUE STRING

L’intervalle de temps à soustraire.

D TIMESTAMP

L’horodatage à soustraire de l’intervalle de temps.

Renvoie¶

Renvoie une date avec la soustraction de l’intervalle de temps et de la date.

Exemple d’utilisation¶

Entrée :

SELECT PUBLIC.DATEDIFF_UDF('INTERVAL ''1-1'' YEAR(2) TO MONTH', TO_TIMESTAMP('2024-01-31 05:09:09.799 -0800'));

Sortie :

2022-12-31 05:09:09.799

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour transformer les valeurs mensuelles en intervalles. Il s’agit d’une fonction auxiliaire.

MONTHS_TO_INTERVAL_UDF
(INPUT_PART VARCHAR(30), INPUT_VALUE NUMBER)

Paramètres¶

INPUT_PART VARCHAR

Le type du deuxième paramètre. Par exemple YEARTOMONTH, YEAR, MONTH.

INPUT_VALUE VARCHAR

Le mois à convertir en intervalles.

Renvoie¶

Renvoie un varchar avec la valeur d’entrée transformée en intervalle.

Exemple d’utilisation¶

Entrée :

SELECT MONTHS_TO_INTERVAL_UDF('YEAR TO MONTH', 2);

Sortie :

2

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour soustraire un horodatage d’un intervalle de temps.

DATEDIFF_UDF(D TIMESTAMP, INTERVAL_VALUE STRING)

Paramètres¶

D TIMESTAMP

L’horodatage qui sera soustrait de l’intervalle de temps.

INTERVAL_VALUE STRING

L’intervalle de temps à soustraire.

Renvoie¶

Renvoie une date avec la soustraction de l’intervalle de temps et de la date.

Exemple d’utilisation¶

Entrée :

SELECT PUBLIC.DATEDIFF_UDF(TO_TIMESTAMP('2024-01-31 05:09:09.799 -0800'), 'INTERVAL ''1-1'' YEAR(2) TO MONTH');

Sortie :

2022-12-31 05:09:09.799

Définition¶

Cette fonction définie par l’utilisateur (UDF) reproduit la fonctionnalité Teradata et Oracle TRUNC(numérique) lorsqu’une échelle n’est pas spécifiée.

TRUNC_UDF(INPUT NUMBER)

Paramètres¶

INPUT NUMBER

Le nombre à tronquer.

Renvoie¶

Renvoie un int en tant qu’entrée tronquée à zéro décimal.

Exemple d’utilisation¶

Entrée :

SELECT TRUNC_UDF(25122.3368)

Sortie :

25122

Définition¶

Cette fonction définie par l’utilisateur (UDF) reproduit la fonctionnalité Teradata et Oracle TRUNC(numérique) lorsqu’une échelle est spécifiée.

TRUNC_UDF(INPUT NUMBER, SCALE NUMBER)

Paramètres¶

INPUT NUMBER

Le nombre à tronquer.

SCALE NUMBER

Le nombre de places à tronquer (entre -38 et 38).

Renvoie¶

Renvoie un int comme entrée tronquée à l’échelle des places.

Exemple d’utilisation¶

Entrée :

SELECT TRUNC_UDF(25122.3368, -2);

Sortie :

25100

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour ajouter ou soustraire des intervalles avec un type de temps spécifique.

INTERVAL_ADD_UDF
(INPUT_VALUE1 VARCHAR(), INPUT_PART1 VARCHAR(30), INPUT_VALUE2 VARCHAR(), INPUT_PART2 VARCHAR(30), OP CHAR, OUTPUT_PART VARCHAR())

Paramètres¶

INPUT_VALUE1 VARCHAR

La quantité référencée à un type de temps.

INPUT_PART1 VARCHAR

Le type de temps de _ INPUT_VALUE1_. Par exemple : HOUR.

INPUT_VALUE2 VARCHAR

La seconde quantité fait référence à un type de temps.

INPUT_PART2 VARCHAR

Le type de temps de _ INPUT_VALUE2_. Par exemple : HOUR.

OP CHAR

L’opération. Je peux être un « + » ou un « - ».

OUTPUT_PART VARCHAR

Le type de temps de l’opération de sortie.

Renvoie¶

Renvoie un varchar contenant le résultat de l’opération et les valeurs indiquées.

Exemple d’utilisation¶

Entrée :

SELECT INTERVAL_ADD_UDF('7', 'HOUR', '1', 'HOUR', '+', 'HOUR');

Sortie :

8

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour ajouter un horodatage à un intervalle de temps.

DATEADD_UDF(INTERVAL_VALUE STRING,D TIMESTAMP)

Paramètres¶

INTERVAL_VALUE STRING

L’intervalle de temps à ajouter.

D TIMESTAMP

L’horodatage à ajouter à l’intervalle de temps.

Renvoie¶

Renvoie une date avec l’addition de l’intervalle de temps et de la date.

Exemple d’utilisation¶

Entrée :

SELECT PUBLIC.DATEADD_UDF('INTERVAL ''1-1'' YEAR(2) TO MONTH', TO_TIMESTAMP('2024-01-31 05:09:09.799 -0800'));

Sortie :

2025-02-28 05:09:09.799

Définition¶

Cette fonction définie par l’utilisateur (UDF) reproduit la fonctionnalité Teradata et Oracle TRUNC(Date) lorsque le paramètre format n’est pas spécifié.

TRUNC_UDF(INPUT TIMESTAMP_LTZ)

Paramètres¶

DATE_TO_TRUNC TIMESTAMP_LTZ

Une valeur timestamp_ltz à tronquer qui doit être une date, un horodatage ou un horodatage avec un fuseau horaire.

Renvoie¶

Renvoie une partie de date de DATE_TO_TRUNC.

Exemple d’utilisation¶

Entrée :

SELECT TRUNC_UDF(TIMESTAMP '2015-08-18 12:30:00')

Sortie :

2015-08-18

Définition¶

Cette fonction définie par l’utilisateur (UDF) est utilisée pour ajouter un horodatage à un intervalle de temps.

DATEADD_UDF(D TIMESTAMP, INTERVAL_VALUE STRING)

Paramètres¶

D TIMESTAMP

L’horodatage à ajouter à l’intervalle de temps.

INTERVAL_VALUE STRING

L’intervalle de temps à ajouter.

Renvoie¶

Renvoie une date avec l’addition de l’intervalle de temps et de la date.

Exemple d’utilisation¶

Entrée :

SELECT PUBLIC.DATEADD_UDF(TO_TIMESTAMP('2024-01-31 05:09:09.799 -0800'), 'INTERVAL ''1-1'' YEAR(2) TO MONTH');

Sortie :

2025-02-28 05:09:09.799