Fonctions

Une fonction ACLScript est une routine informatisée dans Analytics, avec une étendue étroite, qui effectue une tâche ou un calcul spécifique et renvoie une valeur.

Par exemple, la fonction ALLTRIM( ) supprime les espaces de début ou de fin dans les valeurs texte d'un champ.

Liste des fonctions

La liste complète de toutes les fonctions disponibles dans Analytics, classées par ordre alphabétique ou par catégorie, s'affiche ci-après.

Les conventions utilisées dans la syntaxe des fonctions et dans la documentation des fonctions ainsi que certaines informations d'utilisation générales sont également indiquées.

Fonctions dans l'ordre alphabétique

Fonction Description

ABS( )

Renvoie la valeur absolue d'une expression numérique. La valeur absolue d'un nombre correspond au nombre sans son signe.

AGE( )

Renvoie le nombre de jours écoulés (l'antériorité) entre une date spécifiée et une date limite donnée ou la date actuelle du système d'exploitation ou bien le nombre de jours écoulés entre deux dates.

ALLTRIM( )

Renvoie une chaîne dont les espaces de début et de fin ont été supprimées de la chaîne d'entrée.

ASCII( )

Renvoie le code ASCII pour le caractère indiqué.

AT( )

Renvoie un nombre indiquant l'emplacement de début d'une occurrence spécifique d'une sous-chaîne dans une valeur de caractère.

BETWEEN( )

Renvoie une valeur logique indiquant si la valeur indiquée fait partie d'une plage.

BINTOSTR( )

Renvoie des données caractère Unicode converties à partir de données caractère ZONED ou EBCDIC. Abréviation de "Binaire à Chaîne".

BIT( )

Renvoie la représentation binaire de la position d'octet indiquée dans l'enregistrement actuel en tant que chaîne à huit caractères.

BLANKS( )

Renvoie une chaîne contenant un nombre spécifique d'espaces.

BYTE( )

Renvoie le caractère stocké dans la position d'octet indiquée de l'enregistrement actuel.

CDOW( )

Renvoie le nom du jour de la semaine de la date ou de la DateHeure indiquée. Abréviation de "Jour de la semaine au format caractère".

CHR( )

Renvoie le caractère associé au code ASCII indiqué.

CLEAN( )

Remplace le premier caractère non valide, et tous les caractères suivants, d'une chaîne par des blancs.

CMOY( )

Renvoie le nom du mois de l'année de la date ou de la DateHeure indiquée. Abréviation de "Mois de l'année au format caractère".

COS( )

Renvoie le cosinus d'un angle exprimé en radians, avec une précision de 15 décimales.

CTOD( )

Convertit une valeur de date au format Caractère ou Numérique en date. Cette fonction peut également extraire la date d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme de date. Abréviation de "Caractère à Date".

CTODT( )

Convertit une valeur DateHeure au format Caractère ou Numérique en DateHeure. Abréviation de "Caractère à DateHeure".

CTOT( )

Convertit une valeur de type heure au format Caractère ou Numérique en heure. Cette fonction peut également extraire l'heure d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme d'heure. Abréviation de "Caractère à Heure".

CUMIPMT( )

Renvoie le montant cumulé des intérêts payés sur un emprunt pendant une plage de périodes.

CUMPRINC( )

Renvoie le montant cumulé du remboursement du capital sur un emprunt pendant une plage de périodes.

DATE( )

Extrait la date d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer la date du système d'exploitation en cours d'utilisation.

DATETIME( )

Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure du système d'exploitation en cours d'utilisation.

DAY( )

Extrait le jour du mois d'une date ou d'une DateHeure spécifiée et le renvoie sous forme de valeur numérique (1 à 31).

DBYTE( )

Renvoie le caractère Unicode situé à la position d'octet indiquée dans un enregistrement.

DEC( )

Renvoie une valeur ou le résultat d'une expression numérique avec le nombre de décimales indiqué.

DHEX( )

Convertit une chaîne Unicode en chaîne hexadécimale.

DICECOEFFICIENT( )

Renvoie le coefficient de Dice de deux chaînes de caractères spécifiées : il s'agit de la mesure de la similarité entre deux chaînes.

DIGIT( )

Renvoie le chiffre supérieur ou inférieur d'un octet de type Données compactées indiqué.

DOW( )

Renvoie une valeur numérique (1 à 7) représentant le jour de la semaine de la date ou de la DateHeure indiquée. Abréviation de "Jour de la semaine".

DTOU( )

Convertit une valeur date Analytics en chaîne de caractères Unicode dans la langue et le format régional spécifiés. Abréviation de "Date en Unicode".

EBCDIC( )

Renvoie une chaîne convertie en codage de caractère EBCDIC.

EFFECTIVE( )

Renvoie le taux d'intérêt annuel réel d'un emprunt.

EOMONTH( )

Renvoie la date du dernier jour du mois qui correspond au nombre de mois indiqué avant ou après une date indiquée.

EXCLUDE( )

Renvoie une chaîne qui exclut les caractères spécifiés.

EXP( )

Renvoie la valeur exponentielle (base 10) d'une expression numérique avec un nombre de décimales indiqué.

FILESIZE( )

Renvoie la taille du fichier spécifié en octets ou -1 si le fichier n'existe pas.

FIND( )

Renvoie une valeur logique indiquant si la chaîne indiquée est présente dans un champ particulier ou n'importe où dans un enregistrement entier.

FINDMULTI( )

Renvoie une valeur logique indiquant si une chaîne de caractères dans un ensemble d'une ou plusieurs chaînes de caractères spécifiée est présente dans un champ particulier ou quelque part dans un enregistrement entier.

FREQUENCY( )

Renvoie la fréquence Benford attendue pour des chiffres numériques positifs et séquentiels de tête avec une précision de huit décimales.

FTYPE( )

Renvoie un caractère identifiant la catégorie de données d'un champ ou d'une variable, ou le type d'un élément de projet Analytics.

FVANNUITY( )

Renvoie la valeur capitalisée d'une série de paiements calculés à l'aide d'un taux d'intérêt constant. La valeur capitalisée correspond à la somme des paiements augmentée des intérêts composés cumulés.

FVLUMPSUM( )

Renvoie la valeur capitalisée d'un montant forfaitaire en cours calculé à l'aide d'un taux d'intérêt constant.

FVSCHEDULE( )

Renvoie la valeur capitalisée d'un montant forfaitaire en cours calculé à l'aide d'une série de taux d'intérêt.

GETOPTIONS( )

Renvoie le paramètre actuel pour l'option Analytics spécifiée (paramètre de la boîte de dialogue Options).

GOMONTH( )

Renvoie la date qui correspond au nombre de mois indiqué avant ou après une date indiquée.

HASH( )

Renvoie une valeur de hachage cryptographique salted à partir de la valeur d'introduction.

HEX( )

Convertit une chaîne ASCII en chaîne hexadécimale.

HOUR( )

Extrait l'heure d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique à l'aide de l'horloge de 24 heures.

HTOU( )

Convertit une chaîne hexadécimale en chaîne de caractères Unicode. Abréviation de "Hexadécimal à Unicode".

INCLUDE( )

Renvoie une chaîne qui inclut uniquement les caractères spécifiés.

INSERT( )

Renvoie la chaîne d'origine avec le texte spécifié inséré à un emplacement d'octet spécifique.

INT( )

Renvoie la valeur entière d'une expression numérique ou d'une valeur de champ.

IPMT( )

Renvoie les intérêts payés sur un emprunt pour une seule période.

ISBLANK( )

Renvoie une valeur logique indiquant si la valeur d'entrée est vide.

ISDEFINED( )

Renvoie T (« true », vrai) si le champ ou la variable indiqué est défini ; renvoie F (« false », faux) dans les autres cas.

ISFUZZYDUP( )

Renvoie une valeur logique indiquant si une chaîne est un doublon approximatif d'une chaîne de comparaison.

LAST( )

Renvoie un nombre spécifique de caractères à partir de la fin d'une chaîne.

LEADING( )

Renvoie une chaîne contenant un nombre spécifique de chiffres dominants.

LEADINGZEROS( )

Ajoute des zéros de début à une chaîne de caractères ou à un nombre.

LENGTH( )

Renvoie le nombre de caractères dans une chaîne.

LEVDIST( )

Renvoie la distance Levenshtein entre deux chaînes données. Il s'agit d'une mesure du niveau de différence entre les deux chaînes.

LOG( )

Renvoie le logarithme (base 10) d'une expression numérique ou d'une valeur de champ comportant un nombre spécifique de décimales.

LOWER( )

Renvoie une chaîne dont les caractères alphabétiques ont été convertis en minuscules.

LTRIM( )

Renvoie une chaîne dont les espaces de début ont été supprimées de la chaîne d'entrée.

MAP( )

Renvoie une valeur logique indiquant si une chaîne de caractères correspond à une chaîne au format spécifié avec des caractères génériques, des caractères littéraux ou les deux.

MASK( )

Effectue une opération au niveau du bit AND sur les premiers octets des chaînes de deux caractères.

MATCH( )

Renvoie une valeur logique indiquant si la valeur spécifiée correspond à l'une des valeurs à laquelle celle-ci est comparée.

MAXIMUM( )

Renvoie la valeur maximale d'un jeu de valeurs numériques ou bien la valeur la plus récente d'un jeu de valeurs DateHeure.

MINIMUM( )

Renvoie la valeur minimale d'un jeu de valeurs numériques ou bien la valeur la plus ancienne d'un jeu de valeurs DateHeure.

MINUTE( )

Extrait les minutes d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique.

MOD( )

Renvoie le reste de l'opération de division de deux nombres.

MONTH( )

Extrait le mois d'une date ou d'une DateHeure spécifiée et le renvoie sous forme de valeur numérique (1 à 12).

NOMINAL( )

Renvoie le taux d'intérêt annuel nominal d'un emprunt.

NORMDIST( )

Renvoie la probabilité qu'une variable aléatoire d'un jeu de données d'une loi normale soit inférieure ou égale à une valeur spécifiée ou exactement égale à une valeur spécifiée.

NORMSINV( )

Renvoie la variable centrée réduite associée à une probabilité spécifiée dans une loi normale centrée réduite. La variable centrée réduite est le nombre d'écarts-types qui séparent une valeur de la moyenne d'une loi normale centrée réduite.

NOW( )

Renvoie l'heure du système d'exploitation en cours d'utilisation sous forme de données de type DateHeure.

NPER( )

Renvoie les périodes nécessaires pour rembourser un emprunt.

OCCURS( )

Renvoie un décompte du nombre de fois qu'une sous-chaîne se produit dans une valeur de caractères indiquée.

OFFSET( )

Renvoie la valeur d'un champ dont la position de départ a été décalée par un certain nombre d'octets.

OMIT( )

Renvoie une chaîne dont une ou plusieurs sous-chaînes spécifiques ont été supprimées.

PACKED( )

Renvoie des données numériques converties en type de données Packed.

PI( )

Renvoie la valeur de pi à 15 décimales.

PMT( )

Renvoie le montant du paiement périodique (capital + intérêt) requis pour rembourser un emprunt.

PPMT( )

Renvoie le capital payé sur un emprunt pour une seule période.

PROPER( )

Renvoie une chaîne dans laquelle le premier caractère de chaque mot est en majuscule, tandis que les caractères restants sont définis en minuscules.

PROPERTIES( )

Renvoie les informations de propriétés pour l'élément de projet Analytics spécifié.

PVANNUITY( )

Renvoie la valeur actualisée d'une série de paiements futurs calculés à l'aide d'un taux d'intérêt constant. La valeur actualisée correspond à la valeur d'un montant forfaitaire en cours.

PVLUMPSUM( )

Renvoie la valeur actualisée requise pour générer un montant forfaitaire futur spécifique calculé à l'aide d'un taux d'intérêt constant. La valeur actualisée correspond à la valeur d'un montant forfaitaire en cours.

PYDATE( )

Renvoie une valeur date calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYDATETIME( )

Renvoie une valeur DateHeure calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYLOGICAL( )

Renvoie une valeur logique calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYNUMERIC( )

Renvoie une valeur numérique calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYSTRING( )

Renvoie une valeur de type caractère calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYTIME( )

Renvoie une valeur heure calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

RAND( )

Renvoie un nombre aléatoire situé dans les limites spécifiées.

RATE( )

Renvoie le taux d'intérêt par période.

RDATE( )

Renvoie une valeur date calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RDATETIME( )

Renvoie une valeur DateHeure calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RECLEN( )

Renvoie la longueur de l'enregistrement en cours.

RECNO( )

Renvoie le numéro de l'enregistrement actuel.

RECOFFSET( )

Renvoie une valeur de champ à partir d'un enregistrement qui correspond à un nombre défini d'enregistrements issus de l'enregistrement actuel.

REGEXFIND( )

Renvoie une valeur logique indiquant si le modèle spécifié par une expression ordinaire se produit dans une chaîne de caractères.

REGEXREPLACE( )

Remplace toutes les instances de chaînes de caractères correspondant à une expression ordinaire par une nouvelle chaîne de caractères.

REMOVE( )

Renvoie une chaîne qui inclut uniquement les caractères spécifiés.

REPEAT( )

Renvoie une chaîne répétant un certain nombre de fois une sous-chaîne.

REPLACE( )

Remplace toutes les instances d'une chaîne de caractères indiquée par une nouvelle chaîne de caractères.

REVERSE( )

Renvoie une chaîne dont l'ordre des caractères est inversé.

RJUSTIFY( )

Renvoie une chaîne justifiée à droite dont la longueur est égale à celle d'une chaîne indiquée et dont les espaces de fin ont été déplacés vers la gauche de la chaîne.

RLOGICAL( )

Renvoie une valeur logique calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RNUMERIC( )

Renvoie une valeur numérique calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

ROOT( )

Renvoie la racine carrée d'une expression numérique.

ROUND( )

Renvoie un nombre entier arrondi pour une valeur numérique.

RSTRING( )

Renvoie une valeur de chaîne de caractères calculée par un script ou une fonction R. Le traitement des données dans Rvachev est externe à Analytics.

RTIME( )

Renvoie une valeur heure calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

SECOND( )

Extrait les secondes d'une heure ou d'une DateHeure spécifiée et les renvoie sous forme de valeur numérique.

SHIFT( )

Renvoie une chaîne de caractères unique dont les bits issus du premier caractère de la valeur d'entrée ont été déplacés vers la gauche ou vers la droite.

SIN( )

Renvoie le sinus d'un angle exprimé en radians, avec une précision de 15 décimales.

SORTWORDS( )

Renvoie une chaîne contenant des mots individuels triés dans un ordre séquentiel.

SOUNDEX( )

Renvoie le code soundex pour la chaîne indiquée. Ce dernier peut être utilisé pour effectuer des comparaisons phonétiques avec d'autres chaînes.

SOUNDSLIKE( )

Renvoie une valeur logique indiquant si une chaîne correspond phonétiquement à une chaîne de comparaison.

SPLIT( )

Renvoie un segment spécifié d'une chaîne de caractères.

STOD( )

Convertit une date sérielle – c'est-à-dire, une date exprimée sous forme d'intègre – en valeur de date. Abréviation de "Sérielle à Date".

STODT( )

Convertit une valeur DateHeure sérielle – c'est-à-dire, une DateHeure exprimée sous forme d'une intègre, et une portion fractionnelle de 24 heures – en une valeur correspondant à une DateHeure. Abréviation de "Sérielle à DateHeure".

STOT( )

Convertit une valeur horaire sérielle – c'est-à-dire une heure exprimée sous forme d'une portion fractionnelle de 24 heures, où 24 heures équivalent à 1 – en une valeur correspondant à une heure. Abréviation de "Sérielle à Heure".

STRING( )

Convertit une valeur numérique en chaîne de caractères.

SUBSTR( )

Renvoie une sous-chaîne indiquée d'une chaîne de caractères.

TAN( )

Renvoie la tangente d'un angle exprimée en radians, avec une précision de 15 décimales.

TEST( )

Renvoie une valeur logique précisant si une chaîne indiquée se trouve à une position d'octet spécifique dans un enregistrement.

TIME( )

Extrait l'heure d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer l'heure du système d'exploitation en cours d'utilisation.

TODAY( )

Renvoie la date du système d'exploitation en cours d'utilisation sous forme de données de type DateHeure.

TRANSFORM( )

Inverse l'ordre d'affichage du texte bidirectionnel dans une chaîne indiquée.

TRIM( )

Renvoie une chaîne dont les espaces de fin ont été supprimées de la chaîne d'entrée.

UNSIGNED( )

Renvoie des données numériques converties en type de données Unsigned.

UPPER( )

Renvoie une chaîne dont les caractères alphabétiques ont été convertis en majuscules.

UTOD( )

Convertit une chaîne de caractères Unicode contenant une date mise en forme en valeur date Analytics. Abréviation de "Unicode en Date".

VALUE( )

Convertit une chaîne de caractères en valeur numérique.

VERIFY( )

Renvoie une valeur logique indiquant si les données incluses dans un champ de données physique sont valides.

WORKDAY( )

Renvoie le nombre de jours ouvrables entre deux dates.

YEAR( )

Extrait l'année d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique à l'aide du format AAAA.

ZONED( )

Convertit les données numériques en caractères et ajoute des zéros de tête à la sortie.

ZSTAT( )

Renvoie la statistique Z standard.

Rechercher, remplacer

Fonction Description

AT( )

Renvoie un nombre indiquant l'emplacement de début d'une occurrence spécifique d'une sous-chaîne dans une valeur de caractère.

BETWEEN( )

Renvoie une valeur logique indiquant si la valeur indiquée fait partie d'une plage.

CLEAN( )

Remplace le premier caractère non valide, et tous les caractères suivants, d'une chaîne par des blancs.

FIND( )

Renvoie une valeur logique indiquant si la chaîne indiquée est présente dans un champ particulier ou n'importe où dans un enregistrement entier.

FINDMULTI( )

Renvoie une valeur logique indiquant si une chaîne de caractères dans un ensemble d'une ou plusieurs chaînes de caractères spécifiée est présente dans un champ particulier ou quelque part dans un enregistrement entier.

ISBLANK( )

Renvoie une valeur logique indiquant si la valeur d'entrée est vide.

MAP( )

Renvoie une valeur logique indiquant si une chaîne de caractères correspond à une chaîne au format spécifié avec des caractères génériques, des caractères littéraux ou les deux.

MATCH( )

Renvoie une valeur logique indiquant si la valeur spécifiée correspond à l'une des valeurs à laquelle celle-ci est comparée.

OCCURS( )

Renvoie un décompte du nombre de fois qu'une sous-chaîne se produit dans une valeur de caractères indiquée.

REGEXFIND( )

Renvoie une valeur logique indiquant si le modèle spécifié par une expression ordinaire se produit dans une chaîne de caractères.

REGEXREPLACE( )

Remplace toutes les instances de chaînes de caractères correspondant à une expression ordinaire par une nouvelle chaîne de caractères.

REPLACE( )

Remplace toutes les instances d'une chaîne de caractères indiquée par une nouvelle chaîne de caractères.

TEST( )

Renvoie une valeur logique précisant si une chaîne indiquée se trouve à une position d'octet spécifique dans un enregistrement.

Comparaison

Fonction Description

DICECOEFFICIENT( )

Renvoie le coefficient de Dice de deux chaînes de caractères spécifiées : il s'agit de la mesure de la similarité entre deux chaînes.

ISFUZZYDUP( )

Renvoie une valeur logique indiquant si une chaîne est un doublon approximatif d'une chaîne de comparaison.

LEVDIST( )

Renvoie la distance Levenshtein entre deux chaînes données. Il s'agit d'une mesure du niveau de différence entre les deux chaînes.

SOUNDEX( )

Renvoie le code soundex pour la chaîne indiquée. Ce dernier peut être utilisé pour effectuer des comparaisons phonétiques avec d'autres chaînes.

SOUNDSLIKE( )

Renvoie une valeur logique indiquant si une chaîne correspond phonétiquement à une chaîne de comparaison.

Conversion

Fonction Description

BINTOSTR( )

Renvoie des données caractère Unicode converties à partir de données caractère ZONED ou EBCDIC. Abréviation de "Binaire à Chaîne".

CTOD( )

Convertit une valeur de date au format Caractère ou Numérique en date. Cette fonction peut également extraire la date d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme de date. Abréviation de "Caractère à Date".

CTODT( )

Convertit une valeur DateHeure au format Caractère ou Numérique en DateHeure. Abréviation de "Caractère à DateHeure".

CTOT( )

Convertit une valeur de type heure au format Caractère ou Numérique en heure. Cette fonction peut également extraire l'heure d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme d'heure. Abréviation de "Caractère à Heure".

DATE( )

Extrait la date d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer la date du système d'exploitation en cours d'utilisation.

DATETIME( )

Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure du système d'exploitation en cours d'utilisation.

DTOU( )

Convertit une valeur date Analytics en chaîne de caractères Unicode dans la langue et le format régional spécifiés. Abréviation de "Date en Unicode".

EBCDIC( )

Renvoie une chaîne convertie en codage de caractère EBCDIC.

HASH( )

Renvoie une valeur de hachage cryptographique salted à partir de la valeur d'introduction.

LEADINGZEROS( )

Ajoute des zéros de début à une chaîne de caractères ou à un nombre.

PACKED( )

Renvoie des données numériques converties en type de données Packed.

STOD( )

Convertit une date sérielle – c'est-à-dire, une date exprimée sous forme d'intègre – en valeur de date. Abréviation de "Sérielle à Date".

STODT( )

Convertit une valeur DateHeure sérielle – c'est-à-dire, une DateHeure exprimée sous forme d'une intègre, et une portion fractionnelle de 24 heures – en une valeur correspondant à une DateHeure. Abréviation de "Sérielle à DateHeure".

STOT( )

Convertit une valeur horaire sérielle – c'est-à-dire une heure exprimée sous forme d'une portion fractionnelle de 24 heures, où 24 heures équivalent à 1 – en une valeur correspondant à une heure. Abréviation de "Sérielle à Heure".

STRING( )

Convertit une valeur numérique en chaîne de caractères.

TIME( )

Extrait l'heure d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer l'heure du système d'exploitation en cours d'utilisation.

UNSIGNED( )

Renvoie des données numériques converties en type de données Unsigned.

UTOD( )

Convertit une chaîne de caractères Unicode contenant une date mise en forme en valeur date Analytics. Abréviation de "Unicode en Date".

VALUE( )

Convertit une chaîne de caractères en valeur numérique.

ZONED( )

Convertit les données numériques en caractères et ajoute des zéros de tête à la sortie.

Texte

Fonction Description

ALLTRIM( )

Renvoie une chaîne dont les espaces de début et de fin ont été supprimées de la chaîne d'entrée.

BINTOSTR( )

Renvoie des données caractère Unicode converties à partir de données caractère ZONED ou EBCDIC. Abréviation de "Binaire à Chaîne".

BLANKS( )

Renvoie une chaîne contenant un nombre spécifique d'espaces.

DATETIME( )

Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure du système d'exploitation en cours d'utilisation.

DTOU( )

Convertit une valeur date Analytics en chaîne de caractères Unicode dans la langue et le format régional spécifiés. Abréviation de "Date en Unicode".

EBCDIC( )

Renvoie une chaîne convertie en codage de caractère EBCDIC.

EXCLUDE( )

Renvoie une chaîne qui exclut les caractères spécifiés.

INCLUDE( )

Renvoie une chaîne qui inclut uniquement les caractères spécifiés.

INSERT( )

Renvoie la chaîne d'origine avec le texte spécifié inséré à un emplacement d'octet spécifique.

LAST( )

Renvoie un nombre spécifique de caractères à partir de la fin d'une chaîne.

LEADINGZEROS( )

Ajoute des zéros de début à une chaîne de caractères ou à un nombre.

LENGTH( )

Renvoie le nombre de caractères dans une chaîne.

LOWER( )

Renvoie une chaîne dont les caractères alphabétiques ont été convertis en minuscules.

LTRIM( )

Renvoie une chaîne dont les espaces de début ont été supprimées de la chaîne d'entrée.

OMIT( )

Renvoie une chaîne dont une ou plusieurs sous-chaînes spécifiques ont été supprimées.

PROPER( )

Renvoie une chaîne dans laquelle le premier caractère de chaque mot est en majuscule, tandis que les caractères restants sont définis en minuscules.

REMOVE( )

Renvoie une chaîne qui inclut uniquement les caractères spécifiés.

REPEAT( )

Renvoie une chaîne répétant un certain nombre de fois une sous-chaîne.

REVERSE( )

Renvoie une chaîne dont l'ordre des caractères est inversé.

RJUSTIFY( )

Renvoie une chaîne justifiée à droite dont la longueur est égale à celle d'une chaîne indiquée et dont les espaces de fin ont été déplacés vers la gauche de la chaîne.

SORTWORDS( )

Renvoie une chaîne contenant des mots individuels triés dans un ordre séquentiel.

SPLIT( )

Renvoie un segment spécifié d'une chaîne de caractères.

STRING( )

Convertit une valeur numérique en chaîne de caractères.

SUBSTR( )

Renvoie une sous-chaîne indiquée d'une chaîne de caractères.

TRANSFORM( )

Inverse l'ordre d'affichage du texte bidirectionnel dans une chaîne indiquée.

TRIM( )

Renvoie une chaîne dont les espaces de fin ont été supprimées de la chaîne d'entrée.

UPPER( )

Renvoie une chaîne dont les caractères alphabétiques ont été convertis en majuscules.

ZONED( )

Convertit les données numériques en caractères et ajoute des zéros de tête à la sortie.

Mathématiques

Fonction Description

ABS( )

Renvoie la valeur absolue d'une expression numérique. La valeur absolue d'un nombre correspond au nombre sans son signe.

COS( )

Renvoie le cosinus d'un angle exprimé en radians, avec une précision de 15 décimales.

DEC( )

Renvoie une valeur ou le résultat d'une expression numérique avec le nombre de décimales indiqué.

EXP( )

Renvoie la valeur exponentielle (base 10) d'une expression numérique avec un nombre de décimales indiqué.

FREQUENCY( )

Renvoie la fréquence Benford attendue pour des chiffres numériques positifs et séquentiels de tête avec une précision de huit décimales.

INT( )

Renvoie la valeur entière d'une expression numérique ou d'une valeur de champ.

LEADING( )

Renvoie une chaîne contenant un nombre spécifique de chiffres dominants.

LOG( )

Renvoie le logarithme (base 10) d'une expression numérique ou d'une valeur de champ comportant un nombre spécifique de décimales.

MAXIMUM( )

Renvoie la valeur maximale d'un jeu de valeurs numériques ou bien la valeur la plus récente d'un jeu de valeurs DateHeure.

MINIMUM( )

Renvoie la valeur minimale d'un jeu de valeurs numériques ou bien la valeur la plus ancienne d'un jeu de valeurs DateHeure.

MOD( )

Renvoie le reste de l'opération de division de deux nombres.

NORMDIST( )

Renvoie la probabilité qu'une variable aléatoire d'un jeu de données d'une loi normale soit inférieure ou égale à une valeur spécifiée ou exactement égale à une valeur spécifiée.

NORMSINV( )

Renvoie la variable centrée réduite associée à une probabilité spécifiée dans une loi normale centrée réduite. La variable centrée réduite est le nombre d'écarts-types qui séparent une valeur de la moyenne d'une loi normale centrée réduite.

PI( )

Renvoie la valeur de pi à 15 décimales.

RAND( )

Renvoie un nombre aléatoire situé dans les limites spécifiées.

ROOT( )

Renvoie la racine carrée d'une expression numérique.

ROUND( )

Renvoie un nombre entier arrondi pour une valeur numérique.

SIN( )

Renvoie le sinus d'un angle exprimé en radians, avec une précision de 15 décimales.

TAN( )

Renvoie la tangente d'un angle exprimée en radians, avec une précision de 15 décimales.

VALUE( )

Convertit une chaîne de caractères en valeur numérique.

ZONED( )

Convertit les données numériques en caractères et ajoute des zéros de tête à la sortie.

ZSTAT( )

Renvoie la statistique Z standard.

Date et heure

Fonction Description

AGE( )

Renvoie le nombre de jours écoulés (l'antériorité) entre une date spécifiée et une date limite donnée ou la date actuelle du système d'exploitation ou bien le nombre de jours écoulés entre deux dates.

CDOW( )

Renvoie le nom du jour de la semaine de la date ou de la DateHeure indiquée. Abréviation de "Jour de la semaine au format caractère".

CMOY( )

Renvoie le nom du mois de l'année de la date ou de la DateHeure indiquée. Abréviation de "Mois de l'année au format caractère".

CTOD( )

Convertit une valeur de date au format Caractère ou Numérique en date. Cette fonction peut également extraire la date d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme de date. Abréviation de "Caractère à Date".

CTODT( )

Convertit une valeur DateHeure au format Caractère ou Numérique en DateHeure. Abréviation de "Caractère à DateHeure".

CTOT( )

Convertit une valeur de type heure au format Caractère ou Numérique en heure. Cette fonction peut également extraire l'heure d'une valeur de type DateHeure au format Caractère ou Numérique et la renvoyer sous forme d'heure. Abréviation de "Caractère à Heure".

DATE( )

Extrait la date d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer la date du système d'exploitation en cours d'utilisation.

DATETIME( )

Convertit une DateHeure en une chaîne de caractères. Peut également renvoyer la DateHeure du système d'exploitation en cours d'utilisation.

DAY( )

Extrait le jour du mois d'une date ou d'une DateHeure spécifiée et le renvoie sous forme de valeur numérique (1 à 31).

DOW( )

Renvoie une valeur numérique (1 à 7) représentant le jour de la semaine de la date ou de la DateHeure indiquée. Abréviation de "Jour de la semaine".

EOMONTH( )

Renvoie la date du dernier jour du mois qui correspond au nombre de mois indiqué avant ou après une date indiquée.

GOMONTH( )

Renvoie la date qui correspond au nombre de mois indiqué avant ou après une date indiquée.

HOUR( )

Extrait l'heure d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique à l'aide de l'horloge de 24 heures.

MAXIMUM( )

Renvoie la valeur maximale d'un jeu de valeurs numériques ou bien la valeur la plus récente d'un jeu de valeurs DateHeure.

MINIMUM( )

Renvoie la valeur minimale d'un jeu de valeurs numériques ou bien la valeur la plus ancienne d'un jeu de valeurs DateHeure.

MINUTE( )

Extrait les minutes d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique.

MONTH( )

Extrait le mois d'une date ou d'une DateHeure spécifiée et le renvoie sous forme de valeur numérique (1 à 12).

NOW( )

Renvoie l'heure du système d'exploitation en cours d'utilisation sous forme de données de type DateHeure.

SECOND( )

Extrait les secondes d'une heure ou d'une DateHeure spécifiée et les renvoie sous forme de valeur numérique.

STOD( )

Convertit une date sérielle – c'est-à-dire, une date exprimée sous forme d'intègre – en valeur de date. Abréviation de "Sérielle à Date".

STODT( )

Convertit une valeur DateHeure sérielle – c'est-à-dire, une DateHeure exprimée sous forme d'une intègre, et une portion fractionnelle de 24 heures – en une valeur correspondant à une DateHeure. Abréviation de "Sérielle à DateHeure".

STOT( )

Convertit une valeur horaire sérielle – c'est-à-dire une heure exprimée sous forme d'une portion fractionnelle de 24 heures, où 24 heures équivalent à 1 – en une valeur correspondant à une heure. Abréviation de "Sérielle à Heure".

TIME( )

Extrait l'heure d'une heure ou d'une DateHeure spécifiée et la renvoie sous forme de chaîne de caractères. Peut également renvoyer l'heure du système d'exploitation en cours d'utilisation.

TODAY( )

Renvoie la date du système d'exploitation en cours d'utilisation sous forme de données de type DateHeure.

UTOD( )

Convertit une chaîne de caractères Unicode contenant une date mise en forme en valeur date Analytics. Abréviation de "Unicode en Date".

WORKDAY( )

Renvoie le nombre de jours ouvrables entre deux dates.

YEAR( )

Extrait l'année d'une date ou d'une DateHeure spécifiée et la renvoie sous forme de valeur numérique à l'aide du format AAAA.

Financiers

Fonction Description

CUMIPMT( )

Renvoie le montant cumulé des intérêts payés sur un emprunt pendant une plage de périodes.

CUMPRINC( )

Renvoie le montant cumulé du remboursement du capital sur un emprunt pendant une plage de périodes.

EFFECTIVE( )

Renvoie le taux d'intérêt annuel réel d'un emprunt.

FVANNUITY( )

Renvoie la valeur capitalisée d'une série de paiements calculés à l'aide d'un taux d'intérêt constant. La valeur capitalisée correspond à la somme des paiements augmentée des intérêts composés cumulés.

FVLUMPSUM( )

Renvoie la valeur capitalisée d'un montant forfaitaire en cours calculé à l'aide d'un taux d'intérêt constant.

FVSCHEDULE( )

Renvoie la valeur capitalisée d'un montant forfaitaire en cours calculé à l'aide d'une série de taux d'intérêt.

IPMT( )

Renvoie les intérêts payés sur un emprunt pour une seule période.

NOMINAL( )

Renvoie le taux d'intérêt annuel nominal d'un emprunt.

NPER( )

Renvoie les périodes nécessaires pour rembourser un emprunt.

PMT( )

Renvoie le montant du paiement périodique (capital + intérêt) requis pour rembourser un emprunt.

PPMT( )

Renvoie le capital payé sur un emprunt pour une seule période.

PVANNUITY( )

Renvoie la valeur actualisée d'une série de paiements futurs calculés à l'aide d'un taux d'intérêt constant. La valeur actualisée correspond à la valeur d'un montant forfaitaire en cours.

PVLUMPSUM( )

Renvoie la valeur actualisée requise pour générer un montant forfaitaire futur spécifique calculé à l'aide d'un taux d'intérêt constant. La valeur actualisée correspond à la valeur d'un montant forfaitaire en cours.

RATE( )

Renvoie le taux d'intérêt par période.

Champ et enregistrement

Fonction Description

FTYPE( )

Renvoie un caractère identifiant la catégorie de données d'un champ ou d'une variable, ou le type d'un élément de projet Analytics.

HASH( )

Renvoie une valeur de hachage cryptographique salted à partir de la valeur d'introduction.

ISDEFINED( )

Renvoie T (« true », vrai) si le champ ou la variable indiqué est défini ; renvoie F (« false », faux) dans les autres cas.

OFFSET( )

Renvoie la valeur d'un champ dont la position de départ a été décalée par un certain nombre d'octets.

RECLEN( )

Renvoie la longueur de l'enregistrement en cours.

RECNO( )

Renvoie le numéro de l'enregistrement actuel.

RECOFFSET( )

Renvoie une valeur de champ à partir d'un enregistrement qui correspond à un nombre défini d'enregistrements issus de l'enregistrement actuel.

VERIFY( )

Renvoie une valeur logique indiquant si les données incluses dans un champ de données physique sont valides.

Table, fichier et projet

Fonction Description

FILESIZE( )

Renvoie la taille du fichier spécifié en octets ou -1 si le fichier n'existe pas.

FTYPE( )

Renvoie un caractère identifiant la catégorie de données d'un champ ou d'une variable, ou le type d'un élément de projet Analytics.

GETOPTIONS( )

Renvoie le paramètre actuel pour l'option Analytics spécifiée (paramètre de la boîte de dialogue Options).

PROPERTIES( )

Renvoie les informations de propriétés pour l'élément de projet Analytics spécifié.

Tests de variables

Fonction Description

FTYPE( )

Renvoie un caractère identifiant la catégorie de données d'un champ ou d'une variable, ou le type d'un élément de projet Analytics.

ISDEFINED( )

Renvoie T (« true », vrai) si le champ ou la variable indiqué est défini ; renvoie F (« false », faux) dans les autres cas.

Python

Fonction Description
PYDATE( )

Renvoie une valeur date calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYDATETIME( )

Renvoie une valeur DateHeure calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYLOGICAL( )

Renvoie une valeur logique calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYNUMERIC( )

Renvoie une valeur numérique calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYSTRING( )

Renvoie une valeur de type caractère calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

PYTIME( )

Renvoie une valeur heure calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

R

Fonction Description
RDATE( )

Renvoie une valeur date calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RDATETIME( )

Renvoie une valeur DateHeure calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RLOGICAL( )

Renvoie une valeur logique calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RNUMERIC( )

Renvoie une valeur numérique calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

RSTRING( )

Renvoie une valeur de chaîne de caractères calculée par un script ou une fonction R. Le traitement des données dans Rvachev est externe à Analytics.

RTIME( )

Renvoie une valeur heure calculée par un script ou une fonction de Rvachev. Le traitement des données dans Rvachev est externe à Analytics.

Codage de caractères et d'octets

Fonction Description

ASCII( )

Renvoie le code ASCII pour le caractère indiqué.

BIT( )

Renvoie la représentation binaire de la position d'octet indiquée dans l'enregistrement actuel en tant que chaîne à huit caractères.

BYTE( )

Renvoie le caractère stocké dans la position d'octet indiquée de l'enregistrement actuel.

CHR( )

Renvoie le caractère associé au code ASCII indiqué.

DBYTE( )

Renvoie le caractère Unicode situé à la position d'octet indiquée dans un enregistrement.

DHEX( )

Convertit une chaîne Unicode en chaîne hexadécimale.

DIGIT( )

Renvoie le chiffre supérieur ou inférieur d'un octet de type Données compactées indiqué.

HEX( )

Convertit une chaîne ASCII en chaîne hexadécimale.

HTOU( )

Convertit une chaîne hexadécimale en chaîne de caractères Unicode. Abréviation de "Hexadécimal à Unicode".

MASK( )

Effectue une opération au niveau du bit AND sur les premiers octets des chaînes de deux caractères.

SHIFT( )

Renvoie une chaîne de caractères unique dont les bits issus du premier caractère de la valeur d'entrée ont été déplacés vers la gauche ou vers la droite.

Conventions de syntaxe des fonctions

Convention

Description

parenthèses ( )
  • Les valeurs d'entrée des fonctions doivent être entourées de parenthèses :

    ALLTRIM(Nom_Fournisseur)
  • La parenthèse ouvrante doit être immédiatement suivie du nom de la fonction sans espace intermédiaire :

    ALLTRIM(Nom_Fournisseur)

    et non :

    ALLTRIM (Nom_Fournisseur)
  • Des parenthèses doivent être utilisées même si aucune valeur d'introduction n'est indiquée :

    RECNO( )
séparateurs
  • Les valeurs d'introduction des fonctions doivent être séparées par un séparateur :

    SUBSTRING(ID_produit;5;12)
  • Les caractères de séparation valides sont l'espace vide, la virgule et le point-virgule.

    La virgule ou le point-virgule de séparation doit être spécifié dans l'option Séparateur de liste dans l'onglet Numérique dans la boîte de dialogue Options.

Astuce

Pour une meilleure lisibilité, vous pouvez utiliser à la fois une espace vide et un des autres caractères de séparation :

SUBSTRING(ID_produit; 5; 12)
qualificateurs
  • Des guillemets simples ou doubles sont requis autour des valeurs de type caractère littérales :

    EXCLUDE(ID_produit; "#-")
  • Des guillemets inversés sont requis autour des valeurs DateHeure littérales :

    AGE(Date_échéance ; `20141231`)
  • Aucun qualificateur n'est utilisé avec des valeurs numériques :

    ABS(-7,2)
  • Aucun qualificateur n'est utilisé avec des valeurs logiques ( T / F ) :

    LEVDIST(Nom_Fournisseur; Nom_Fournisseur_2; F)
  • Aucun qualificateur n'est utilisé avec les noms des champs :

    ALLTRIM(Nom_Fournisseur)
format DateHeure littéral
  • Les valeurs date littérales doivent être saisies au format AAAAMMJJ ou AAMMJJ :
    • `20141231`
    • `141231`
  • Les valeurs heure littérales doivent être saisies au format hhmmss ou hhmm et précédées d'une espace, T ou t :
    • `t235959`
    • `20141231 2359`

Abréger les noms de fonctions

Attention

ACL recommande de ne pas abréger les noms des fonctions dans les champs calculés, expressions ou scripts et d'utiliser la version complète de chaque nom.

En effet, les abréviations rendent les champs calculés, les expressions ou les scripts plus difficiles à lire et à comprendre. Sans les noms complets des fonctions, leur recherche dans l'aide en ligne s'avère plus compliqué.

Les abréviations posent d'autant plus de problèmes que vos projets Analytics ou scripts seront modifiés ou hérités par quelqu'un d'autre qui est susceptible de ne pas connaître ces abréviations.

Lorsque vous indiquez des fonctions dans des champs calculés, des expressions ou des scripts, vous pouvez abréger leurs noms. Vous devez inclure assez de caractères de début à un nom de fonction pour identifier de manière unique la fonction parmi toutes les fonctions Analytics.

Par exemple :

  • MAX identifie de manière unique la fonction MAXIMUM ; il s'agit donc d'une abréviation valide.
  • MA n'identifie pas de manière unique la fonction MAXIMUM et génère un message d'erreur.

Vous pouvez raccourcir une abréviation autant que possible tant qu'elle continue d'identifier la fonction de manière unique.

Par exemple, toutes les abréviations suivantes sont valides pour la fonction ALLTRIM :

  • ALLTR
  • ALLT
  • ALL
  • AL

Remarque

À mesure que les abréviations se raccourcissent, il devient de plus en plus difficile pour les autres utilisateurs de les reconnaître.

Conventions utilisées dans la documentation des fonctions

Convention

Utilisé pour :

MAJUSCULE

Le nom de la fonction ACLScript.

Remarque

Dans la documentation Analytics, les noms des fonctions sont en majuscules ; cela relève simplement d'une convention de format. Il n'est pas nécessaire pour Analytics que les fonctions soient saisies en majuscules.

italique

Paramètres de fonctions fournis par l'utilisateur.

|

(barre verticale)

Sépare les éléments de syntaxe entre crochets ou accolades. Vous ne pouvez utiliser qu'un seul élément.

< >

(crochets obliques)

Éléments de syntaxe facultatifs. Ne saisissez pas les crochets.

{ }

(accolades)

Éléments de syntaxe obligatoires. Ne saisissez pas les accolades.

<;...n>

Indique que l'élément précédent peut être répété un nombre n de fois. Les occurrences sont séparées par des points-virgules.

Termes utilisés pour les types de données dans la documentation des fonctions

Les termes suivants sont utilisés pour identifier le type de données des arguments des paramètres de fonctions ainsi que les valeurs renvoyées :

Terme

Cela signifie que vous pouvez utiliser :

Caractère Tout nom de champ, expression, variable appartenant à la catégorie Caractère (C) d'Analytics ou à un littéral de chaîne
Numérique Nom de champ, expression, variable ou valeur numérique appartenant à la catégorie de données Numérique (N) d'Analytics.
DateHeure Nom de champ, expression ou variable appartenant à la catégorie Dateheure (D) d'Analytics ou littéral DateHeure.
Logique Tout nom de champ, expression, variable ou toute valeur logique appartenant à la catégorie Logique (L) d'Analytics
Champ Nom d'un champ provenant de n'importe quelle catégorie de données Analytics