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

ADD_TO_DATE

ADD_TO_DATE

Ajoute un nombre spécifié à une partie d'une valeur date/heure et renvoie une date au même format que celle que vous transmettez à la fonction. ADD_TO_DATE accepte des valeurs entières positives et négatives. Utilisez ADD_TO_DATE pour modifier les parties suivantes d'une date :
  • Année.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez les chaînes de format de l'année : Y, YY, YYY, ou YYYY. L'expression suivante ajoute 10 ans à toutes les dates dans le port SHIP_DATE :
    ADD_TO_DATE ( SHIP_DATE, 'YY', 10 )
  • Mois.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez les chaînes de format de mois suivantes : MM, MON, MONTH. L'expression suivante soustrait 10 mois à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'MONTH', -10 )
  • Jour.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez une des chaînes de format de jour : D, DD, DDD, DY et DAY. L'expression suivante ajoute 10 jours à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'DD', 10 )
  • Heure.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez une des chaînes de format d'heure : HH, HH12, HH24. L'expression suivante ajoute 14 heures à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'HH', 14 )
  • Minute.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez la chaîne de format MI pour définir les minutes. L'expression suivante ajoute 25 minutes à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'MI', 25 )
  • Secondes.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez la chaîne de format SS pour définir les secondes. L'expression suivante ajoute 59 secondes à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'SS', 59 )
  • Millisecondes.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez la chaîne de format MS pour définir les millisecondes. L'expression suivante ajoute 125 millisecondes à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'MS', 125 )
  • Microsecondes.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez la chaîne de format US pour définir les microsecondes. L'expression suivante ajoute 2000 microsecondes à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'US', 2000 )
  • Nanosecondes.
    Entrez un entier positif ou négatif dans l'argument
    quantité
    . Utilisez la chaîne de format NS pour définir les nanosecondes. L'expression suivante ajoute 3 000 000 nanosecondes à chaque date dans le port SHIP_DATE :
    ADD_TO_DATE( SHIP_DATE, 'NS', 3000000 )

Syntaxe

ADD_TO_DATE( 
date
,
format
,
amount
 )
Le tableau suivant décrit les arguments de cette commande:
Argument
Obligatoire/
Facultatif
Description
date
Obligatoire
Type de données Date/Heure. Transmet les valeurs que vous voulez modifier. Vous pouvez entrer l'expression de transformation valide de votre choix.
format
Obligatoire
Chaîne de format spécifiant la partie de la valeur de date que vous voulez modifier. Placez la chaîne de format entre guillemets simples, par exemple : 'mm'. La chaîne de format n'est pas sensible à la casse.
quantité
Obligatoire
Valeur entière spécifiant le nombre d'années, de mois, de jours, d'heures, etc. par laquelle vous voulez remplacer la valeur de date. Vous pouvez saisir toute expression de transformation valide qui renvoie un nombre entier.

Valeur de retour

Date au même format que celle que vous avez transmise à cette fonction.
NULL si une valeur nulle est transmise comme argument à la fonction.

Exemples

Toutes les expressions suivantes ajoutent un mois à chaque date dans le port DATE_SHIPPED. Si vous transmettez une valeur qui crée un jour qui n'existe pas dans un mois donné, le
Service d'intégration de données
renvoie le dernier jour du mois. Par exemple, si vous ajoutez un mois à Jan 31 1998, le
Service d'intégration de données
renvoie Fev 28 1998.
Notez également que ADD_TO_DATE reconnaît les années bissextiles et ajoute un mois à Jan 29 2000 :
ADD_TO_DATE( DATE_SHIPPED, 'MM', 1 ) ADD_TO_DATE( DATE_SHIPPED, 'MON', 1 ) ADD_TO_DATE( DATE_SHIPPED, 'MONTH', 1 )
DATE_SHIPPED
RETURN VALUE
Jan 12 1998 12:00:30AM
Feb 12 1998 12:00:30AM
Jan 31 1998 6:24:45PM
Feb 28 1998 6:24:45PM
Jan 29 2000 5:32:12AM
Feb 29 2000 5:32:12AM
  (Leap Year)
Oct 9 1998 2:30:12PM
Nov 9 1998 2:30:12PM
NULL
NULL
Les expressions suivantes soustraient 10 jours à chaque date dans le port DATE_SHIPPED :
ADD_TO_DATE( DATE_SHIPPED, 'D', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DD', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DDD', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DY', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DAY', -10 )
DATE_SHIPPED
RETURN VALUE
Jan 1 1997 12:00:30AM
Dec 22 1996 12:00AM
Jan 31 1997 6:24:45PM
Jan 21 1997 6:24:45PM
Mar 9 1996 5:32:12AM
Feb 29 1996 5:32:12AM
  (Leap Year)
Oct 9 1997 2:30:12PM
Sep 30 1997 2:30:12PM
Mar 3 1996 5:12:20AM
Feb 22 1996 5:12:20AM
NULL
NULL
Les expressions suivantes soustraient 15 heures à chaque date dans le port DATE_SHIPPED :
ADD_TO_DATE( DATE_SHIPPED, 'HH', -15 ) ADD_TO_DATE( DATE_SHIPPED, 'HH12', -15 ) ADD_TO_DATE( DATE_SHIPPED, 'HH24', -15 )
DATE_SHIPPED
RETURN VALUE
Jan 1 1997 12:00:30AM
Dec 31 1996 9:00:30AM
Jan 31 1997 6:24:45PM
Jan 31 1997 3:24:45AM
Oct 9 1997 2:30:12PM
Oct 8 1997 11:30:12PM
Mar 3 1996 5:12:20AM
Mar 2 1996 2:12:20PM
Mar 1 1996 5:32:12AM
Feb 29 1996 2:32:12PM
  (Leap Year)
NULL
NULL

Utilisation des dates

Suivez les conseils suivants lorsque vous travaillez avec ADD_TO_DATE :
  • Vous pouvez ajouter ou soustraire une partie de la date en définissant une chaîne de format et en modifiant l'argument
    quantité
    par un nombre entier positif ou négatif.
  • Si vous transmettez une valeur qui crée un jour qui n'existe pas dans un mois donné, le
    Service d'intégration de données
    renvoie le dernier jour du mois. Par exemple, si vous ajoutez un mois à Jan 31 1998, le
    Service d'intégration de données
    renvoie Fev 28 1998.
  • Vous pouvez imbriquer TRUNC et ROUND pour manipuler les dates.
  • Vous pouvez imbriquer TO_DATE pour convertir des chaînes en dates.
  • ADD_TO_DATE modifie uniquement la partie de la date que vous indiquez. Si vous modifiez une date pour passer de l'heure standard à l'heure d'été, vous devez changer la partie heure de la date.