INTNX |
Intervalle du prochain |
|---|---|
| SAS | Temps |
Syntaxe
| INTNX(interval<multiple><.shift-index>, start-from, increment<,alignment>) |
Paramètres
| Nom | Description | |
|---|---|---|
| interval | Ce paramètre permet d'indiquer une constante, une variable ou une expression de caractères contenant un intervalle de temps tel que WEEK, SEMIYEAR, QTR ou HOUR. | |
| multiple | Ce paramètre permet d'indiquer un multiplicateur facultatif définissant l'intervalle égale à un multiple de la période du type d'intervalle de base. | |
| shift-index | Ce paramètre permet d'indiquer un index de décalage facultatif déplaçant l'intervalle pour démarrer à un point de départ de la sous-période spécifié. | |
| start-from | Ce paramètre permet d'indiquer une expression SAS représentant une date, une heure ou une une combinaison de date et heure (datetime) identifiant un point de départ. | |
| increment | Ce paramètre permet d'indiquer un nombre entier négatif, positif ou nul représentant le nombre d'intervalles de date, d'heure ou de date et heure (datetime). | |
| alignment | Ce paramètre permet d'indiquer un contrôle de position des dates SAS dans l'intervalle : | |
| Valeur | Description | |
| B | Cette valeur permet d'indiquer que la date ou la date et heure de retour sont alignés au début de l'intervalle. | |
| BEGINNING | Cette valeur permet d'indiquer que la date ou la date et heure de retour sont alignés au début de l'intervalle. | |
| E | Cette valeur permet d'indiquer que la date ou la date et heure de retour sont alignés à la fin de l'intervalle. | |
| END | Cette valeur permet d'indiquer que la date ou la date et heure de retour sont alignés à la fin de l'intervalle. | |
| M | Cette valeur permet d'indiquer que la date ou la date et heure de retour sont alignés au milieu de l'intervalle. | |
| MIDDLE | Cette valeur permet d'indiquer que la date ou la date et heure de retour sont alignés au milieu de l'intervalle. | |
| S | Cette valeur permet d'indiquer que l'intervalle est aligné dans le même jour. | |
| SAMEDAY | Cette valeur permet d'indiquer que l'intervalle est aligné dans le même jour. | |
Description
Cette fonction avance la date, l'heure ou le «datetime» dans un intervalle donné et la retourne sous forme de date, d'heure ou de «datetime». Dans les faits, la fonction INTNX incrémente une valeur de date, d'heure ou de date/heure par intervalles, tels que DAY, WEEK, QTR et MINUTE, ou un intervalle personnalisé que vous spécifiez. L'incrémentation est basé sur une date de début, une heure ou une valeur de date et heure, ainsi que sur le nombre d'intervalles de temps que vous spécifiez. La fonction INTNX renvoie la valeur de date SAS pour la date de début, l'heure ou la valeur de date-heure de l'intervalle que vous spécifiez dans le paramètre start-from.
Remarques
- Pour convertir la valeur de date SAS en date de calendrier, vous devez utilisez un format de date SAS valide, tel que le format DATE9, car celui-ci offre la possibilité d'indiquer une année en 4 chiffres.
- Les valeurs de date SAS sont généralement alignées avec le début de l'intervalle de temps spécifié avec le paramètre interval. Vous pouvez utiliser le paramètre alignment facultatif pour spécifier l'alignement de la date a retourner. Les valeurs BEGINNING, MIDDLE ou END alignent respectivement, la date au début de l'intervalle, au milieu de l'intervalle ou à la fin de l'intervalle.
- Si vous utilisez la valeur SAME du paramètre alignment, la fonction INTNX retourne la même date de calendrier après avoir calculé l'incrémentation d'intervalle que vous avez spécifié. La même date de calendrier est alignée en fonction de la période de décalage de l'intervalle, et non de l'intervalle.
Exemples
Voici un exemple montrant l'utilisation de la fonction INTNX :
on obtiendra le résultat suivant :
621001JAN77
5904
01MAR76
Voici un exemple montrant l'utilisation de la fonction INTNX par alignement :
on obtiendra le résultat suivant :
1512701JUN2001
15506
15JUN2002
15886
30JUN2003