--- sourceDocument: Yokohama Créer ou modifier des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/application-development Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Yokohama Créer ou modifier des applications ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- Formules pour les valeurs de colonne dans Générateur de tables ============================================================== Formules pour les valeurs de colonne dans Générateur de tables {#ariaid-title1} =============================================================================== * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 minutes de lecture Vous pouvez utiliser une fonction prédéfinie et créer une formule pour calculer la valeur d'une colonne sans écrire de script. Utilisez une fonction prédéfinie ou créez une formule imbriquée à l'aide des fonctions prédéfinies existantes pour calculer le type de valeur de colonne. Opérateurs pris en charge {#formulas-columns-table-builder__section_nq4_fld_g5b} -------------------------------------------------------------------------------- Les opérateurs de comparaison suivants ne sont pris en charge que pour les valeurs de type nombre. * = (Égal à) * \<\> (non égal à) * \> (supérieur à) * \< (inférieur à) * \>= (Supérieur ou égal à) * \<= (inférieur ou égal à) {#formulas-columns-table-builder__ul_wg3_3ld_g5b} Fonctions mathématiques simples {#ariaid-title2} ------------------------------------------------ Utilisez des fonctions mathématiques simples pour effectuer des calculs mathématiques de base sur des colonnes de valeurs numériques. ### MOYENNE {#simple-math-functions-table-builder__section_xmc_yfn_ytb} Renvoie la valeur moyenne des arguments. {#simple-math-functions-table-builder__table_ckw_zfn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-------------------------------------------------|-------------------------------------------------|------------------| | AVERAGE(argument 1, argument 2, ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_ckw_zfn_ytb}Exemples : * Fonction : AVERAGE(1,2,3)Le résultat est 2. * Formule : AVERAGE(LENGTH(first_name), LENGTH(last_name))Le résultat est la valeur moyenne du nombre de caractères dans la colonne first_name et last_name colonne. {#simple-math-functions-table-builder__ul_y21_3tt_ytb} ### DIVISER {#simple-math-functions-table-builder__section_skl_l24_ytb} Renvoie la valeur du quotient final après avoir divisé consécutivement le premier argument avec l'argument suivant jusqu'à ce que la fonction atteigne le dernier argument. {#simple-math-functions-table-builder__table_fdf_n24_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------------------------|-------------------------------------------------|------------------| | DIVIDE(argument 1, argument 2 ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_fdf_n24_ytb}Exemples : * Fonction : DIVIDE(10,20, 0.25, 10)Le résultat est de 0,2. * Formule : DIVIDE(LENGTH(full_name),2)Le résultat est le nombre de caractères dans la colonne full_name divisé par 2. {#simple-math-functions-table-builder__ul_apt_qd5_ytb} ### INDEXMATCH {#simple-math-functions-table-builder__section_y2x_mfn_dwb} Récupère la première valeur non nulle à partir de l'ensemble d'arguments spécifié.{#simple-math-functions-table-builder__table_lb3_qfn_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------------------------------|----------------------------------------------------------|------------------| | INDEXMATCH(argument 1, argument 2 , ... argument n) | chaîne, valeur numérique, appel de fonction ou variable. | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_lb3_qfn_dwb}Exemple : Fonction : INDEXMATCH(\<\< \>\>, \>\> \<\< ,2,"string \>\>) Le résultat est 2. ### MAX {#simple-math-functions-table-builder__section_c5k_23n_ytb} Renvoie la valeur la plus élevée des arguments spécifiés. {#simple-math-functions-table-builder__table_amb_g3n_ytb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------------------------------|-------------------------------------------------|------------------| | MAX(argument 1, argument 2, ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_amb_g3n_ytb}Exemples : * Fonction : MAX(1, -5, 20, 6)Le résultat est 20. * Formule : MAX(LENGTH(first_name), LENGTH(last_name))Le résultat est le nombre de caractères dans la colonne first_name ou last_name colonne, selon le chiffre le plus élevé. {#simple-math-functions-table-builder__ul_lqm_svt_ytb} ### MIN. {#simple-math-functions-table-builder__section_xv1_h24_ytb} Renvoie la valeur la plus faible des arguments spécifiés. {#simple-math-functions-table-builder__table_kt3_324_ytb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------------------------------|-------------------------------------------------|------------------| | MIN(argument 1, argument 2, ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_kt3_324_ytb}Exemples : * Fonction : MIN(1, -5, 20, 6)Le résultat est -5. * Formule : MIN(LONGUEUR(first_name), LONGUEUR(last_name))Il en résulte le nombre de caractères dans la colonne first_name ou last_name colonne, selon le chiffre le plus bas. {#simple-math-functions-table-builder__ul_qws_nd5_ytb} ### MULTIPLIER {#simple-math-functions-table-builder__section_nyn_qcn_ytb} Renvoie la valeur totale multipliée des arguments. {#simple-math-functions-table-builder__table_t4r_gdn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------------------------------------|-------------------------------------------------|------------------| | MULTIPLY (argument 1, argument 2, ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_t4r_gdn_ytb} Exemples : * Fonction : MULTIPLY(12, 4) Le résultat est 48. * Formule : MULTIPLY(order, 2)Le résultat est la valeur de colonne d'ordre multipliée par 2. {#simple-math-functions-table-builder__ul_gsd_pf4_ytb} ### POUVOIR {#simple-math-functions-table-builder__section_hcg_3kn_ytb} Renvoie le résultat de la valeur de base élevé à la puissance de la valeur de l'exposant. {#simple-math-functions-table-builder__table_e35_mkn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | POWER(argument 1, argument 2) | l'argument 1 est la base et l'argument 2 est l'exposant. * base : nombre ou variable * exposant : nombre ou variable {#simple-math-functions-table-builder__ul_elh_rkn_ytb} | Numéro | [ ] {#simple-math-functions-table-builder__table_e35_mkn_ytb}Exemples : * Fonction : POWER(3,2)Le résultat est 9. * Formule : POWER(LENGTH(full_name),2)Le résultat est le nombre de caractères dans la colonne full_name à la puissance 2. {#simple-math-functions-table-builder__ul_ogq_tc5_ytb} ### SOUSTRAIRE {#simple-math-functions-table-builder__section_qs3_njn_ytb} Renvoie la valeur du résultat après avoir soustrait consécutivement le prochain argument disponible de l'argument précédent jusqu'à ce que la fonction atteigne le dernier argument. {#simple-math-functions-table-builder__table_elz_4jn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-------------------------------------------------|-------------------------------------------------|------------------| | SUBTRACT(argument 1, argument 2 ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_elz_4jn_ytb}Exemples : * Fonction : SUBTRACT(1.15, 0.02, 0.45, -0.85) Le résultat est de 1,53. * Formule : SUBTRACT(LENGTH(full_name), LENGTH(first_name))Le résultat est le nombre de caractères de la colonne full_name moins le nombre de caractères de la colonne first_name. {#simple-math-functions-table-builder__ul_s3j_dc5_ytb} ### SOMME {#simple-math-functions-table-builder__section_u3v_p24_ytb} Renvoie la somme de tous les arguments. {#simple-math-functions-table-builder__table_qtw_q24_ytb__entry__3} | Syntaxe | Entrée | Sortie | |--------------------------------------------|-------------------------------------------------|------------------| | SUM(argument 1,argument 2, ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_qtw_q24_ytb}Exemples : * Fonction : SUM(0,03, -0,02, 1)Le résultat est de 1,01. * Formule : SOMME(LONGUEUR(first_name), LONGUEUR(last_name))Il en résulte le nombre total de caractères dans la colonne first_name plus le nombre total de caractères dans la colonne last_name. {#simple-math-functions-table-builder__ul_yl3_xd5_ytb} ### COMPTE SI {#simple-math-functions-table-builder__section_vdh_xd4_dwb} Renvoie le nombre d'arguments qui correspondent aux critères spécifiés dans le jeu d'arguments spécifié.{#simple-math-functions-table-builder__table_p1x_yd4_dwb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------| | COUNTIF(argument 1, argument 2, argument n-1, critères) | * argument 1 ... argument n : chaîne, valeur numérique, appel de fonction ou variable. * critères : critères qui évaluent le jeu d'arguments spécifié. chaîne, valeur numérique, appel de fonction ou variable. {#simple-math-functions-table-builder__ul_lqv_124_dwb} | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_p1x_yd4_dwb}Exemple : Fonction : COUNTIF(2,3,2,"string \>\>,2) Le résultat est 2. ### MODE {#simple-math-functions-table-builder__section_ixn_r24_dwb} Renvoie la valeur qui se répète le plus fréquemment dans le jeu d'arguments spécifié.{#simple-math-functions-table-builder__table_mz2_1f4_dwb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------------------------------|-------------------------------------------------|------------------| | MODE(argument 1,argument 2, ... argument n) | valeur numérique, appel de fonction ou variable | Valeur numérique | [ ] {#simple-math-functions-table-builder__table_mz2_1f4_dwb}Exemple : Fonction : MODE(1, 2, 2, 3, 3, 3) Le résultat est 3. Fonctions de chaînes {#ariaid-title3} ------------------------------------- Utilisez les fonctions de chaîne pour reformater ou effectuer des calculs sur les valeurs de colonne de chaîne. ### CONCATÉNER {#string-functions-table-builder__section_mjk_zkn_ytb} Réunit une ou plusieurs chaînes d'entrée en une seule chaîne. {#string-functions-table-builder__table_ayq_bln_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------------------------|---------------------------------------|--------| | CONCATENATE(chaîne 1, chaîne 2, ... chaîne n) | chaîne, appel de fonction ou variable | Chaîne | [ ] {#string-functions-table-builder__table_ayq_bln_ytb}Exemples : * Fonction : CONCATENATE(first_name, \<\< . \>\>, last_name, \<\< @ \>\>, LOWERCASE(example), \<\< .com \>\>)Le résultat est la valeur concaténée \.\@example.com. Dans cet exemple, \ et \ sont des espaces réservés. * Fonction : CONCATÉNER (first_name, " \<\< , last_name)Le résultat est la chaîne concaténée de first_name valeur de colonne et last_name valeur de colonne séparées par un espace. {#string-functions-table-builder__ul_wfm_zc5_ytb} ### ISBLANK {#string-functions-table-builder__section_wlx_fjn_ytb} Recherche les espaces blancs ou les valeurs vides dans la chaîne de caractères et renvoie \<\< vrai \>\> s'il y en a. {#string-functions-table-builder__table_jgr_3jn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-------------------|------------------|---------------| | ISBLANK(argument) | Chaîne ou valeur | True ou False | [ ] {#string-functions-table-builder__table_jgr_3jn_ytb}Exemples : * Fonction : ISBLANK(\<\< example_string \>\>)Le résultat est faux. * Fonction : ISBLANK(full_name)Le résultat n'est vrai que lorsqu'il y a des espaces vides dans la colonne full_name. Sinon, le résultat est faux. {#string-functions-table-builder__ul_uk5_xb5_ytb} ### LONGUEUR {#string-functions-table-builder__section_wz5_pgn_ytb} Renvoie le nombre total de caractères dans la chaîne d'entrée. {#string-functions-table-builder__table_sz1_sgn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |------------------|-------------------------------------------------|------------------| | LENGTH(argument) | valeur de chaîne, appel de fonction ou variable | Valeur numérique | [ ] {#string-functions-table-builder__table_sz1_sgn_ytb}Exemples : * Fonction : LENGTH(\<\< example_string \>\>)Le résultat est 14. * Fonction : LONGUEUR(full_name)Le résultat est le nombre total de caractères dans la valeur de colonne full_name. {#string-functions-table-builder__ul_crp_c5t_ytb} ### MINUSCULE {#string-functions-table-builder__section_ufr_sjn_ytb} Convertit la chaîne d'entrée en caractères tout en minuscule. {#string-functions-table-builder__table_sc1_vjn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------|---------------------------------------|----------------------| | LOWERCASE(argument) | chaîne, appel de fonction ou variable | Chaîne en minuscules | [ ] {#string-functions-table-builder__table_sc1_vjn_ytb}Exemples : * Fonction : LOWERCASE(\<\< ExamPle inpuT stRing \>\>)Le résultat est un exemple de chaîne d'entrée. * Fonction : MINUSCULE(sys_created_by)Le résultat est la chaîne en minuscules de la valeur de colonne sys_created_by. {#string-functions-table-builder__ul_dh4_gc5_ytb} ### REMPLACER {#string-functions-table-builder__section_dfv_2hd_g5b} Remplace les caractères de la chaîne source par ceux de la chaîne cible. {#string-functions-table-builder__table_efv_2hd_g5b__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | REPLACE(source_string, target_string, replacement_string) | * source_string : chaîne, appel de fonction ou variable * target_string : chaîne, appel de fonction ou variable * replacement_string : chaîne, appel de fonction ou variable {#string-functions-table-builder__ul_ffv_2hd_g5b} | Chaîne | [ ] {#string-functions-table-builder__table_efv_2hd_g5b}Exemples : * Fonction : REPLACE(\<\< Pepperoni Pizza \>\>, \<\< Pepperoni \>\>, \<\< Cheese \>\>)La chaîne de résultat est Cheese Pizza. * Fonction : REPLACE(\<\< abe.tuter@example.com \>\>, \<\< example \>\>, company_name)La chaîne de résultat est abe.tuter@\.com. Dans cet exemple, \est un espace réservé. {#string-functions-table-builder__ul_gfv_2hd_g5b} ### TITLECASE {#string-functions-table-builder__section_zl3_l3n_ytb} Convertit la chaîne d'entrée en caractères de casse de titre. {#string-functions-table-builder__table_hwc_r3n_ytb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------|---------------------------------------|--------------------------| | TITLECASE(argument) | chaîne, appel de fonction ou variable | chaîne en casse de titre | [ ] {#string-functions-table-builder__table_hwc_r3n_ytb}Exemples : * Fonction : TITLECASE(\<\< example string \>\>)Le résultat est Example String. * Fonction : TITLECASE(full_name)Il en résulte la valeur de la colonne Nom complet dans la casse du titre. {#string-functions-table-builder__ul_k1z_bb5_ytb} ### MAJUSCULE {#string-functions-table-builder__section_vqx_hgn_ytb} Convertit la chaîne d'entrée en caractères tout en majuscules. {#string-functions-table-builder__table_epc_lgn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------|-------------------------------------------------|----------------------| | UPPERCASE(argument) | valeur de chaîne, appel de fonction ou variable | chaîne en majuscules | [ ] {#string-functions-table-builder__table_epc_lgn_ytb}Exemples : * Fonction : MAJUSCULE(\<\< eXamPle sTring \>\>)Le résultat est EXAMPLE STRING. * Fonction : MAJUSCULE (état)Le résultat est la valeur de la colonne État en majuscules. {#string-functions-table-builder__ul_ilr_ltt_ytb} ### TROUVER {#string-functions-table-builder__section_krg_xgn_dwb} Recherche la première occurrence d'une sous-chaîne dans une chaîne et renvoie la position de la première occurrence. Remarque : Cette fonction est sensible à la casse. {#string-functions-table-builder__table_vvp_1hn_dwb__entry__3} | Syntaxe | Entrée | Sortie | |------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------| | FIND(search_string, source_string, from_index) | * search_string : sous-chaîne, appel de fonction ou variable. * source_string : chaîne principale, appel de fonction ou variable. * from_index : position de l'index dans la chaîne principale à partir de laquelle la recherche doit commencer. valeur numérique, appel de fonction ou variable. {#string-functions-table-builder__ul_pdg_dhn_dwb} | valeur numérique (entier). Lorsque la sous-chaîne n'existe pas dans la chaîne principale, -1 est renvoyé. | [ ] {#string-functions-table-builder__table_vvp_1hn_dwb}Exemple : Fonction : FIND(\<\< morning \>\>, \<\< Good morning \>\>) Le résultat est 5. ### SEARCH {#string-functions-table-builder__section_f4n_tc4_dwb} Recherche une sous-chaîne dans une chaîne et renvoie la position de la première occurrence de la sous-chaîne. Remarque : Cette fonction est insensible à la casse. {#string-functions-table-builder__table_udg_zc4_dwb__entry__3} | Syntaxe | Entrée | Sortie | |--------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------| | SEARCH(search_string, source_string, from_index) | * search_string : sous-chaîne, appel de fonction ou variable. * source_string : chaîne principale, appel de fonction ou variable. * from_index : position de l'index dans la chaîne principale à partir de laquelle la recherche doit commencer. valeur numérique, appel de fonction ou variable. {#string-functions-table-builder__ul_izl_cd4_dwb} | valeur numérique (entier). Lorsque la sous-chaîne n'existe pas dans la chaîne principale, -1 est renvoyé. | [ ] {#string-functions-table-builder__table_udg_zc4_dwb}Exemples : * SEARCH(\<\< Morning \>\>, \<\< Good morning \>\>)Le résultat est 5. * SEARCH(\<\< World \>\>,"Hello world ! \>\>)Le résultat est -1. {#string-functions-table-builder__ul_pn1_3d4_dwb} ### SOUS-CHAÎNE {#string-functions-table-builder__section_u5g_cqn_dwb} Récupère une sous-chaîne à partir d'une chaîne à la position d'index et sur la longueur spécifiées.{#string-functions-table-builder__table_jjp_wb4_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | SUBSTRING(source_string, start_index, length) | * source_string : chaîne, appel de fonction ou variable. * start_index : position dans la chaîne à partir de laquelle la sous-chaîne est extraite. valeur numérique, appel de fonction ou variable. * length : longueur de la sous-chaîne qui doit être extraite. {#string-functions-table-builder__ul_gnx_bc4_dwb} | Chaîne | [ ] {#string-functions-table-builder__table_jjp_wb4_dwb}Exemple : SUBSTRING(\<\< Bonjour, bonjour \>\>, 7, 4) La sous-chaîne de résultat est 'bonne'. Fonctions de date et d'heure {#ariaid-title4} --------------------------------------------- Utilisez les fonctions de date et d'heure pour calculer ou reformater les valeurs de colonne de date et d'heure. ### MAINTENANT {#date-time-functions-table-builder__section_lqm_f3d_g5b} Renvoie la date et l'heure actuelles de l'instance au format ISO (AAAA-MM-JJ hh :mm :ss). {#date-time-functions-table-builder__table_mqm_f3d_g5b__entry__3} | Syntaxe | Entrée | Sortie | |--------------|-------------------------------------------|-----------------------------------------------| | MAINTENANT() | aucun argument requis pour cette fonction | format ISO de la date et de l'heure actuelles | [ ] {#date-time-functions-table-builder__table_mqm_f3d_g5b}Exemple : Fonction : NOW() Le résultat est la date et l'heure actuelles au format ISO. ### AUJOURD'HUI {#date-time-functions-table-builder__section_a4f_dnn_dwb} Renvoie la date actuelle avec le décalage horaire par rapport au début de la journée au format ISO dans le fuseau horaire UTC.{#date-time-functions-table-builder__table_mss_gnn_dwb__entry__3} | Syntaxe | Entrée | Sortie | |---------|-------------------------------------------|---------------------------------------------------------------------------------------| | TODAY() | aucun argument requis pour cette fonction | Date actuelle avec décalage horaire par rapport au début de la journée au format ISO. | [ ] {#date-time-functions-table-builder__table_mss_gnn_dwb}Exemple : Fonction : TODAY() Il en résulte la date et l'heure de début actuelles de la journée au format ISO. ### TIMEDIFF {#date-time-functions-table-builder__section_fkr_yjn_ytb} Évalue la différence de durée entre deux dates. {#date-time-functions-table-builder__table_vhc_1kn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |--------------------------------|--------------------------------------------------------------------------------|--------| | TIMEDIFF(argument1, argument2) | Date au format ISO (AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable | Durée | [ ] {#date-time-functions-table-builder__table_vhc_1kn_ytb}Exemples : * Fonction : TIMEDIFF(\<\< 2021-05-02 9:10:12 \>\>, \<\< 2021-04-07 6:2:23 \>\>)Le résultat est 25 03:07:49. * Formule : TIMEDIFF(sys_created_on, NOW())Il en résulte la différence de durée entre la date de sys_created_on et la date actuelle du système. {#date-time-functions-table-builder__ul_t2y_kc5_ytb} ### DATEDIF {#date-time-functions-table-builder__section_km1_13n_dwb} Évalue la différence entre les deux dates en jours, mois ou années.{#date-time-functions-table-builder__table_s4h_33n_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------| | DATEDIF(start_date, end_date, date_difference_unit) | * start_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. * end_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. * date_difference_unit : chaîne de caractères et \<\< Y \>\>, \<\< M \>\> ou \<\< D \>\> en minuscules ou en majuscules. La valeur par défaut est \<\< D \>\>. {#date-time-functions-table-builder__ul_wz5_k3n_dwb} | Valeur numérique de durée basée sur l'unité de différence de date spécifiée. | [ ] {#date-time-functions-table-builder__table_s4h_33n_dwb}Exemple : Fonction : DATEDIF(\<\< 2021-05-02 9:10:12 \>\>, \<\< 2021-05-05 6:2:23 \<\< ,"d \>\>) Le résultat est 3. ### DATE {#date-time-functions-table-builder__section_sn2_gdn_dwb} Crée une date à partir des valeurs individuelles spécifiées d'année, de mois et de jour. La date de création est dans le fuseau horaire UTC (Temps universel coordonné).{#date-time-functions-table-builder__table_ek1_jdn_dwb__entry__3} | Syntaxe | Entrée | Sortie | |----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------| | DATE(year,month,day) | * year : valeur numérique, variable ou fonction. * mois : valeur numérique, variable ou fonction. * day : valeur numérique, variable ou fonction. {#date-time-functions-table-builder__ul_rxg_4dn_dwb} | Date au format ISO (AAAA-MM-JJ hh :mm :ss) | [ ] {#date-time-functions-table-builder__table_ek1_jdn_dwb}Exemple : Fonction : DATE(2021,5,2) Résultat : 2021-05-02 00:00:00. ### JOUR {#date-time-functions-table-builder__section_kkg_zbn_dwb} Récupère la composante numérique du jour à partir de la date spécifiée.{#date-time-functions-table-builder__table_f1h_2cn_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-----------|------------------------------------------------------------------------------------------------------------|--------------------------------------------------------| | DAY(date) | Date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne, de variable ou de fonction. | valeur numérique (entier). Les valeurs vont de 1 à 31. | [ ] {#date-time-functions-table-builder__table_f1h_2cn_dwb}Exemples : * Fonction : DAY(\<\< 2021-05-029:10:12 \>\>)Le résultat est 2. * Fonction : DAY(NOW())Il en résultera le composant jour de la date et de l'heure actuelles. {#date-time-functions-table-builder__ul_z1q_wcn_dwb} ### MOIS {#date-time-functions-table-builder__section_uxz_cfp_dwb} Récupère le composant de mois numérique à partir de la date spécifiée.{#date-time-functions-table-builder__table_gr4_khp_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-------------|------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------| | MONTH(date) | date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. | valeur numérique (entier). Les valeurs sont comprises entre 1 (janvier) et 12 (décembre). | [ ] {#date-time-functions-table-builder__table_gr4_khp_dwb}Exemples : * Fonction : MONTH(\<\< 2021-05-02 9:10:12 \>\>)Le résultat est 5. * Fonction : DAY(NOW())Il en résultera le composant mois de la date et de l'heure actuelles. {#date-time-functions-table-builder__ul_wj5_thp_dwb} ### ANNÉE {#date-time-functions-table-builder__section_cpy_xym_dwb} Récupère le composant de l'année à partir de la date spécifiée.{#date-time-functions-table-builder__table_d3g_2zm_dwb__entry__3} | Syntaxe | Entrée | Sortie | |------------|------------------------------------------------------------------------------------------------------------|---------------------------| | YEAR(date) | Date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne, de variable ou de fonction. | valeur numérique (entier) | [ ] {#date-time-functions-table-builder__table_d3g_2zm_dwb}Exemples : * Fonction : YEAR(\<\< 2021-05-02 9:10:12 \>\>)Le résultat est 2021. * Fonction : YEAR(NOW())Il en résultera le composant année de la date et heure actuelles. {#date-time-functions-table-builder__ul_mnv_4zm_dwb} ### JOUR DE LA SEMAINE {#date-time-functions-table-builder__section_x3r_qjn_dwb} Renvoie le jour numérique de la semaine correspondant à la date spécifiée. La plage de jours est de 1 (dimanche) à 7 (samedi).{#date-time-functions-table-builder__table_acd_sjn_dwb__entry__3} | Syntaxe | Entrée | Sortie | |---------------|------------------------------------------------------------------------------------------------------|---------------------------| | WEEKDAY(date) | date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. | valeur numérique (entier) | [ ] {#date-time-functions-table-builder__table_acd_sjn_dwb}Exemple : Fonction : WEEKDAY(\<\< 2021-05-02 9:10:12 \>\>) Le résultat est 1. ### TEXTE {#date-time-functions-table-builder__section_emz_b1n_dwb} Récupère les composants de date spécifiques d'une date au format chaîne.{#date-time-functions-table-builder__table_znr_d1n_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------| | TEXT(date, format_text) | * date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne, variable. * format_text : composants de date sous forme de chaîne ou de variable qui doivent être extraits. {#date-time-functions-table-builder__ul_lzb_n1n_dwb} | Chaîne | [ ] {#date-time-functions-table-builder__table_znr_d1n_dwb}Exemple : TEXT(\<\< 2022-08-17 9:10:12 \>\>,"aaaa-MM \>\>) Le résultat est 2022-08. ### VALEUR DE DATE {#date-time-functions-table-builder__section_qzy_3n4_dwb} Convertit une date au format texte en une date au format ISO.{#date-time-functions-table-builder__table_opb_d44_dwb__entry__3} | Syntaxe | Entrée | Sortie | |----------------------|---------------------------------------------------------------------------------|------------------------------------------------------------------| | DATEVALUE(date_text) | date_text : la date stockée sous forme de texte doit être au format AAAA-MM-JJ. | Date au format ISO (AAAA-MM-JJ hh :mm :ss) sous forme de chaîne. | [ ] {#date-time-functions-table-builder__table_opb_d44_dwb}Exemple : Fonction : DATEVALUE(\<\< 2021-05-02 \>\>) Résultat : 2021-05-02 00:00:00. ### JOUR OUVRABLE {#date-time-functions-table-builder__section_cb3_ydn_dwb} Renvoie le jour ouvrable le plus proche de la date d'entrée spécifiée en excluant les jours fériés et les week-ends spécifiés avant ou après le nombre n de jours spécifié.{#date-time-functions-table-builder__table_zyw_b2n_dwb__entry__3} | Syntaxe | Entrée | Sortie | |---------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------| | WORKDAY(start_date, jours, jour férié 1, jour férié 2, ..., jour férié n) | * start_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. * days : nombre de jours sous forme de valeur numérique, de chaîne ou de fonction. * holiday 1...holiday n (Facultatif) : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. {#date-time-functions-table-builder__ul_lhw_h2n_dwb} | Date au format ISO (AAAA-MM-JJ hh :mm :ss) sous forme de chaîne. | [ ] {#date-time-functions-table-builder__table_zyw_b2n_dwb}Exemple : Fonction : WORKDAY(\<\< 2022-08-17 9:10:12 \>\>,2) Le résultat est 2022-08-19 00:00:00. ### JOURS-RÉSEAU {#date-time-functions-table-builder__section_trs_4f4_dwb} Calcule le nombre de jours ouvrables entre deux dates en excluant les week-ends et les dates de jours fériés spécifiées. Le nombre de jours ouvrables inclut la date de début et la date de fin.{#date-time-functions-table-builder__table_opy_qf4_dwb__entry__3} | Syntaxe | Entrée | Sortie | |------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------| | NETWORKDAYS(start_date,end_date,jour férié 1,jour férié 2, ... jour férié n) | * start_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. * end_date : date au format ISO (AAAA-MM-JJ ou AAAA-MM-JJ hh :mm :ss) sous forme de chaîne ou de variable. * Jour férié 1, Jour férié 2, ... Jours fériés n (facultatif) : liste des jours fériés à exclure lors du calcul des jours ouvrables. {#date-time-functions-table-builder__ul_ilg_5f4_dwb} | valeur numérique (entier) | [ ] {#date-time-functions-table-builder__table_opy_qf4_dwb}Exemple : Fonction : NETWORKDAYS(\<\< 2022-08-17 20:10:12 \>\>,"2022-08-19 9:10:12 \>\>) Le résultat est 3. Fonctions logiques {#ariaid-title5} ----------------------------------- Utilisez des fonctions logiques pour effectuer des opérations logiques sur les valeurs de colonne. ### ET {#logical-functions-table-builder__section_hh1_fln_ytb} Exécute une opération logique AND sur les arguments. {#logical-functions-table-builder__table_skg_224_ytb__entry__3} | Syntaxe | Entrée | Sortie | |-----------------------------|---------------------------------------|---------------| | AND(argument 1, argument 2) | chaîne, appel de fonction ou variable | True ou False | [ ] {#logical-functions-table-builder__table_skg_224_ytb}Exemples : * Fonction : ET(2\>3, 4\<5) Le résultat est faux. * Formule : ET(LONGUEUR(sys_created_by)\>25, LONGUEUR(sys_updated_by)\>25)Le résultat n'est vrai que lorsque le nombre de caractères dans les colonnes sys_created_by et sys_updated_by est supérieur à 25. Sinon, le résultat est faux. {#logical-functions-table-builder__ul_oh3_kd5_ytb} ### SI {#logical-functions-table-builder__section_nk5_wgn_ytb} Exécute les instructions spécifiées en fonction de la sortie booléenne de l'expression conditionnelle. {#logical-functions-table-builder__table_pt3_zgn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |----------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------| | SI(\, \, \) | * conditional_expression : expression conditionnelle logique, appel de fonction ou variable Remarque : La comparaison logique des chaînes n'est pas prise en charge dans l'expression conditionnelle. * do_this_when_true : chaîne, valeur numérique, appel de fonction ou variable qui est renvoyé lorsque la condition est évaluée comme vraie * do_this_when_false : chaîne, valeur numérique, appel de fonction ou variable qui est renvoyé lorsque la condition est évaluée comme fausse {#logical-functions-table-builder__ul_rl2_fhn_ytb} | chaîne, valeur numérique, appel de fonction ou variable basée sur la sortie booléenne de l'expression conditionnelle. | [ ] {#logical-functions-table-builder__table_pt3_zgn_ytb}Exemples : * Fonction : IF(number_of_incidents \>= 5, \<\< High \>\>, \<\< Medium \>\>)Si le nombre d'incidents est supérieur à 5, la chaîne \<\< Élevé \>\> est renvoyée. Dans les autres cas, la chaîne 'Medium' est renvoyée. * Fonction : IF(LENGTH(full_name) \> 100, \<\< Le nombre de caractères dépasse la limite \>\>, \<\< Nombre de caractères dans la limite \>\>)Si le nombre de caractères de la colonne full_name est supérieur à 100, la chaîne \<\< Le nombre de caractères dépasse la limite \>\> est renvoyée. Sinon, la chaîne \<\< Nombre de caractères dans la limite \>\> est renvoyée. {#logical-functions-table-builder__ul_jhw_n5t_ytb} ### OU {#logical-functions-table-builder__section_bxk_qhn_ytb} Exécute une opération logique OR sur les arguments. {#logical-functions-table-builder__table_nsw_shn_ytb__entry__3} | Syntaxe | Entrée | Sortie | |----------------------------|---------------------------------------|---------------| | OR(argument 1, argument 2) | chaîne, appel de fonction ou variable | True ou False | [ ] {#logical-functions-table-builder__table_nsw_shn_ytb}Exemples : * Fonction : OU(2\>3,4\<5) Le résultat est vrai. * Formule : OU(LONGUEUR(first_name)\>25, LONGUEUR(last_name)\<25)Le résultat est vrai lorsque le nombre de caractères dans la colonne first_name est supérieur à 25 ou que le nombre de caractères dans la colonne last_name est inférieur à 25. Sinon, le résultat est faux. {#logical-functions-table-builder__ul_r3c_hvt_ytb} ### SIERREUR {#logical-functions-table-builder__section_tmx_nln_dwb} Évalue l'expression 1 et renvoie la valeur de l'expression 1 lorsqu'il n'y a pas d'erreur dans l'expression 1. Lorsqu'une erreur se produit lors de l'évaluation de l'expression 1, l'expression 2 est évaluée et la valeur de l'expression 2 est renvoyée. {#logical-functions-table-builder__table_wgl_rln_dwb__entry__3} | Syntaxe | Entrée | Sortie | |-------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------| | IFERROR(expression 1, expression 2) | * expression 1 : arithmétique, expression logique, appel de fonction, chaîne, valeur numérique ou variable. * expression 2 : arithmétique, expression logique, appel de fonction, chaîne, valeur numérique ou variable. {#logical-functions-table-builder__ul_b5r_tln_dwb} | Résultat de l'expression 1 lorsqu'il n'y a pas d'erreurs dans l'expression 1. Dans le cas contraire, résultat de l'expression 2. | [ ] {#logical-functions-table-builder__table_wgl_rln_dwb}Exemple : Fonction : IFERROR( MULTIPLY(snr_factor, signal), MULTIPLY( default_factor, signal)) Si la valeur snr_factor est un nombre valide, la valeur multipliée de snr_factor avec signal est renvoyée. Si la valeur snr_factor n'est pas un nombre valide, la valeur multipliée de default_factor valeur avec signal est renvoyée.