Documentation/Fonctions Calc/CELLULE
TDF LibreOffice Document Liberation Project Blogs communautaires Weblate Nextcloud Redmine Ask LibreOffice Donner
Nom de la fonction :
CELLULE
Catégorie :
Information
Résumé :
Fournit les informations demandées sur l'emplacement, les propriétés de formatage ou le contenu d'une cellule.
Syntaxe :
CELLULE(Type information[; Référence])
Renvoie :
Renvoie une valeur dont le type dépend de la nature des informations demandées.
Arguments :
Type information est une chaîne de texte, ou une référence à une cellule contenant une chaîne de texte, qui détermine le type d'informations à renvoyer. Type information est insensible à la casse et doit correspondre à l'une des options autorisées suivantes : "ADRESSE", "COL", "COULEUR", "CONTENU", "COORD", "NOMFICHIER", "FORMAT", "PARENTHESES", "PREFIX", "PROTECTION", "LIGNE", "FEUILLE", "TYPE" ou "LARGEUR". Le tableau ci-dessous détaille chacune de ces options.
Référence est une référence à la cellule pour laquelle les informations doivent être renvoyées. Si Référence est omise, les informations renvoyées correspondent à la cellule contenant la formule. Référence peut être l'une des valeurs suivantes :
- Une référence à une cellule seule.
- Une référence à une plage de cellules (par exemple: D6:E12).
- Le nom d'une plage nommée
- Le nom d'une plage de base de données.
Lorsque Référence spécifie plusieurs cellules, CELLULE renvoie des informations pour le coin supérieur gauche de ces cellules.
Chaîne Type information | Signification |
---|---|
ADRESSE | Renvoie l'adresse absolue de la cellule. Par exemple :
Les exemples ci-dessus supposent le paramètre par défaut de Calc A1 pour le menu Syntaxe de formule dans la boîte de dialogue ▸ ▸ ▸ ( ▸ ▸ ▸ sur macOS). |
COL | Renvoie le numéro de colonne de la cellule (colonne A est 1, colonne B est 2, etc.). Par exemple :
|
COULEUR | Renvoie une valeur indiquant si les valeurs négatives sont mises en couleur dans la cellule (1 = mise en couleur, 0 = non mise en couleur). Par exemple :
|
CONTENTS | Renvoie le contenu de la cellule, sans mise en forme. Par exemple :
|
COORD | Renvoie l'adresse complète de la cellule en utilisant une notation héritée, dans laquelle la position de la feuille est indiquée par une lettre (A indique la feuille de calcul à gauche de la zone d'onglets, B la feuille suivante à droite, etc.). Par exemple :
L'option "COORD" pour l'argument Type information n'est pas une exigence d'ODF 1.2. |
FILENAME | Renvoie le nom du fichier et celui de la feuille dans laquelle se trouve la cellule. Par exemple :
|
FORMAT | Renvoie une chaîne de caractères indiquant le format numérique de la cellule. Les valeurs de retour possibles sont définies dans un tableau séparé ci-dessous. |
PARENTHESES | Renvoie 1 si le code de format de la cellule contient une parenthèse gauche et 0 dans le cas contraire. Par exemple :
|
PREFIX | Renvoie une chaîne de caractères unique indiquant l'alignement du texte dans la cellule, codée comme suit :
Par exemple :
Renvoie le caractère nul (Unicode U+0000) si la cellule ne contient pas de chaîne. |
PROTECT | Renvoie l'état de protection de la cellule. 1 indique que la cellule est protégée, tandis que 0 indique qu'elle ne l'est pas. Par exemple :
Notez que la protection des cellules n'est effective qu'une fois la feuille active protégée. La protection de cellule peut être activée même si la feuille n'est pas protégée. |
LIGNE | Renvoie le numéro de ligne de la cellule. Par exemple :
|
FEUILLE | Renvoie le numéro de la feuille référencée : 1 indique la feuille à gauche de l'onglet, 2 la feuille suivante à droite, et ainsi de suite. Par exemple :
|
TYPE | Renvoie le type de données de la cellule. L'une des trois chaînes de caractères possibles : b (pour blank) pour une cellule vide ; l (pour label) si la cellule contient du texte ; v (pour value) dans le cas contraire. Par exemple :
La formule |
WIDTH | Renvoie la largeur de la colonne contenant la cellule. L'unité est le nombre de caractères zéro (0) que la colonne peut contenir, selon la police par défaut. Par exemple :
|
Valeur de renvoie | Signification |
---|---|
Nombres | |
, (virgule) | Indique que la cellule est formatée pour afficher les nombres avec séparateurs de milliers. Le nombre de décimales spécifié par le format de cellule est ajouté après la virgule. Par exemple :
|
F | Indique que la cellule est formatée pour afficher les nombres sans séparateur de milliers. Le nombre de décimales spécifié par le format de cellule est ajouté après la lettre F. Par exemple :
|
C | Indique que la cellule est formatée pour afficher les nombres au format monétaire. Le nombre de décimales spécifié par le format de cellule est ajouté après la lettre C. Par exemple :
|
S | Indique que la cellule est formatée pour afficher les nombres en représentation scientifique (exponentielle). Le nombre de décimales spécifié par le format de cellule est ajouté après la lettre S. Par exemple :
|
P | Indique que la cellule est formatée pour afficher des pourcentages. Le nombre de décimales spécifié par le format de cellule est ajouté après la lettre P. Par exemple :
|
Dates | |
D1 | Formats de date comprenant les valeurs de jour, de mois et d'année. Par exemple :
|
D2 | Formats de date comprenant les valeurs de jour et de mois (nom alphabétique abrégé). Par exemple :
|
D3 | Formats de date comprenant les valeurs de mois et d'année. Par exemple :
|
D4 | Formats de date et d'heure comprenant les secondes, les minutes, les heures, le jour, le mois et l'année (sans indicateur AM/PM). Par exemple :
|
D5 | Format de date comprenant le jour et le mois (valeurs numériques). Par exemple :
|
D6 | Formats horaires incluant les secondes, les minutes et les heures, avec indication AM/PM. Par exemple :
|
D7 | Formats horaires incluant les minutes et les heures, avec indication AM/PM. Par exemple :
|
D8 | Formats horaires incluant les secondes, les minutes et les heures, sans indication AM/PM. Par exemple :
|
D9 | Formats horaires incluant les minutes et les heures, sans indicateur AM/PM. Par exemple :
|
G | Tous les autres formats de date et d'heure. Par exemple :
|
Remarques supplémentaires
Un signe moins (-) est ajouté à la fin de la chaîne renvoyée lorsque la cellule est formatée pour afficher les nombres négatifs en couleur. Par exemple :
Des parenthèses () sont ajoutées à la fin de la chaîne renvoyée lorsque le code de format de la cellule inclut une parenthèse gauche. Par exemple :
|
- Si Type d'information ne correspond pas à l'une des chaînes attendues, alors CELLULE signale une erreur d'argument non valide (Err :502).
- Si Référence ne correspond pas à une référence valide, CELLULE signale une erreur #REF !.
- Si Type d'information est défini sur « CONTENU » et Référence est omis, alors CELLULE signale une erreur de référence circulaire (Err :522).
Détails complémentaires :
Aucun
Exemples :
Voir les exemples dans les tableaux de la section #Arguments: ci-dessus.
Fonctions LibreOffice associées :
Aucun.
Standard ODF :
Fonctions Excel relatives (ou similaires) :
CELL