Excel.DoubleCellValue interface

Paquet:

excel

Représente la valeur d’une cellule contenant un double.

Remarques

[ Ensemble d’API : ExcelApi 1.16 ]

Propriétés

basicType	Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue	Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
layouts	Représente des informations de disposition pour les vues de cette valeur double.
numberFormat	Retourne la chaîne de format numérique utilisée pour afficher cette valeur. Lorsqu’elle est accessible via une valuesAsJson propriété, cette chaîne de format numérique se trouve dans les paramètres régionaux en-US. Lorsqu’il est accessible via une valuesAsJsonLocal propriété, ce format de nombre se trouve dans les paramètres régionaux d’affichage de l’utilisateur. Les chaînes de format numérique doivent être conformes aux instructions Excel. Pour plus d’informations, consultez Consulter les instructions relatives à la personnalisation d’un format de nombre.
properties	Représente des propriétés supplémentaires de cette valeur double.
provider	Représente des informations qui décrivent le service qui a fourni les données dans ce DoubleCellValue. Ces informations peuvent être utilisées pour la personnalisation dans carte vue.
referencedValues	Représente les valeurs de cellule référencées dans DoubleCellValue.properties.
type	Représente le type de cette valeur de cellule.

Détails de la propriété

basicType

Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.

basicType?: RangeValueType.double | "Double";

Valeur de propriété

double | "Double"

Remarques

[ Ensemble d’API : ExcelApi 1.16 ]

basicValue

Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.

basicValue: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi 1.16 ]

layouts

Représente des informations de disposition pour les vues de cette valeur double.

layouts?: BasicViewLayouts;

Valeur de propriété

Excel.BasicViewLayouts

Remarques

[ Ensemble d’API : ExcelApi 1.19 ]

numberFormat

Retourne la chaîne de format numérique utilisée pour afficher cette valeur. Lorsqu’elle est accessible via une valuesAsJson propriété, cette chaîne de format numérique se trouve dans les paramètres régionaux en-US. Lorsqu’il est accessible via une valuesAsJsonLocal propriété, ce format de nombre se trouve dans les paramètres régionaux d’affichage de l’utilisateur. Les chaînes de format numérique doivent être conformes aux instructions Excel. Pour plus d’informations, consultez Consulter les instructions relatives à la personnalisation d’un format de nombre.

numberFormat?: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : ExcelApi 1.19 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml

// This function creates a double data type,
// and sets the format of this data type as a currency.
await Excel.run(async (context) => {
  // Get the Sample worksheet and a range on that sheet.
  const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
  const currencyRange = sheet.getRange("A2");

  // Write a number formatted as currency to cell A2.
  currencyRange.valuesAsJson = [
    [
      {
        type: Excel.CellValueType.double,
        basicValue: 12.34,
        numberFormat: "$* #,##0.00"
      }
    ]
  ];

  await context.sync();
});

properties

Représente des propriétés supplémentaires de cette valeur double.

properties?: {
            [key: string]: EntityPropertyType;
        };

Valeur de propriété

{ [key: string]: Excel.EntityPropertyType; }

Remarques

[ Ensemble d’API : ExcelApi 1.19 ]

provider

Représente des informations qui décrivent le service qui a fourni les données dans ce DoubleCellValue. Ces informations peuvent être utilisées pour la personnalisation dans carte vue.

provider?: CellValueProviderAttributes;

Valeur de propriété

Excel.CellValueProviderAttributes

Remarques

[ Ensemble d’API : ExcelApi 1.19 ]

referencedValues

Représente les valeurs de cellule référencées dans DoubleCellValue.properties.

referencedValues?: ReferencedValue[];

Valeur de propriété

Excel.ReferencedValue[]

Remarques

[ Ensemble d’API : ExcelApi 1.19 ]

type

Représente le type de cette valeur de cellule.

type: CellValueType.double | ReferenceValueType.double | "Double";

Valeur de propriété

double | double | "Double"

Remarques

[ Ensemble d’API : ExcelApi 1.16 ]

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml

// This function creates a double data type,
// and sets the format of this data type as a date.
await Excel.run(async (context) => {
  // Get the Sample worksheet and a range on that sheet.
  const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
  const dateRange = sheet.getRange("A1");

  // Write a number formatted as a date to cell A1.
  dateRange.valuesAsJson = [
    [
      {
        type: Excel.CellValueType.double,
        basicValue: 32889.0,
        numberFormat: "m/d/yyyy"
      }
    ]
  ];
  await context.sync();
});