Excel.DoubleCellValue interface

Stellt den Wert einer Zelle dar, die einen Double-Wert enthält.

Eigenschaften

basicType

Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.

basicValue

Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.

layouts

Stellt Layoutinformationen für Ansichten mit diesem doppelten Wert dar.

numberFormat

Gibt die Zahlenformatzeichenfolge zurück, die zum Anzeigen dieses Werts verwendet wird. Wenn über eine valuesAsJson Eigenschaft auf diese Zahlenformatzeichenfolge zugegriffen wird, befindet sie sich im Gebietsschema en-US. Wenn über eine valuesAsJsonLocal Eigenschaft auf dieses Zahlenformat zugegriffen wird, befindet es sich im Anzeigegebietsschema des Benutzers. Zahlenformatzeichenfolgen müssen den Excel-Richtlinien entsprechen. Weitere Informationen finden Sie unter Richtlinien zum Anpassen eines Zahlenformats.

properties

Stellt zusätzliche Eigenschaften dieses doppelten Wertes dar.

provider

Stellt Informationen dar, die den Dienst beschreiben, der die Daten in diesem DoubleCellValuebereitgestellt hat. Diese Informationen können für das Branding in der Kartenansicht verwendet werden.

referencedValues

Stellt die Zellwerte dar, auf die innerhalb DoubleCellValue.propertiesverwiesen wird.

type

Stellt den Typ dieses Zellwerts dar.

Details zur Eigenschaft

basicType

Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.

basicType?: RangeValueType.double | "Double";

Eigenschaftswert

double | "Double"

Hinweise

API-Satz: ExcelApi 1.16

basicValue

Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.

basicValue: number;

Eigenschaftswert

number

Hinweise

API-Satz: ExcelApi 1.16

layouts

Stellt Layoutinformationen für Ansichten mit diesem doppelten Wert dar.

layouts?: BasicViewLayouts;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.19

numberFormat

Gibt die Zahlenformatzeichenfolge zurück, die zum Anzeigen dieses Werts verwendet wird. Wenn über eine valuesAsJson Eigenschaft auf diese Zahlenformatzeichenfolge zugegriffen wird, befindet sie sich im Gebietsschema en-US. Wenn über eine valuesAsJsonLocal Eigenschaft auf dieses Zahlenformat zugegriffen wird, befindet es sich im Anzeigegebietsschema des Benutzers. Zahlenformatzeichenfolgen müssen den Excel-Richtlinien entsprechen. Weitere Informationen finden Sie unter Richtlinien zum Anpassen eines Zahlenformats.

numberFormat?: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.19

Beispiele

// 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

Stellt zusätzliche Eigenschaften dieses doppelten Wertes dar.

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

Eigenschaftswert

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

Hinweise

API-Satz: ExcelApi 1.19

provider

Stellt Informationen dar, die den Dienst beschreiben, der die Daten in diesem DoubleCellValuebereitgestellt hat. Diese Informationen können für das Branding in der Kartenansicht verwendet werden.

provider?: CellValueProviderAttributes;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.19

referencedValues

Stellt die Zellwerte dar, auf die innerhalb DoubleCellValue.propertiesverwiesen wird.

referencedValues?: ReferencedValue[];

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.19

type

Stellt den Typ dieses Zellwerts dar.

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

Eigenschaftswert

double | double | "Double"

Hinweise

API-Satz: ExcelApi 1.16

Beispiele

// 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();
});