Freigeben über

Excel.DoubleCellValue interface

Paket:
excel

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

Hinweise

[ API-Satz: ExcelApi 1.16 ]

Eigenschaften

basicType

Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue

Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
layouts

Stellt Layoutinformationen für Ansichten dieses Double-Werts dar.
numberFormat

Gibt die Zahlenformatzeichenfolge zurück, die zum Anzeigen dieses Werts verwendet wird. Beim Zugriff über eine valuesAsJson Eigenschaft befindet sich diese Zahlenformatzeichenfolge im Gebietsschema en-US. Beim Zugriff über eine valuesAsJsonLocal Eigenschaft befindet sich dieses Zahlenformat im Anzeigegebietsschema des Benutzers. Zahlenformatzeichenfolgen müssen den Excel-Richtlinien entsprechen. Weitere Informationen finden Sie unter Überprüfen von Richtlinien zum Anpassen eines Zahlenformats.
properties

Stellt zusätzliche Eigenschaften dieses double-Werts 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 Karte Ansicht verwendet werden.
referencedValues

Stellt die Zellwerte dar, auf die in DoubleCellValue.propertiesverwiesen wird.
type

Stellt den Typ dieses Zellwerts dar.

Details zur Eigenschaft

basicType

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

basicType?: RangeValueType.double | "Double";

Eigenschaftswert

double | "Double"

Hinweise

[ API-Satz: ExcelApi 1.16 ]

basicValue

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

basicValue: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.16 ]

layouts

Stellt Layoutinformationen für Ansichten dieses Double-Werts dar.

layouts?: BasicViewLayouts;

Eigenschaftswert

Excel.BasicViewLayouts

Hinweise

[ API-Satz: ExcelApi 1.19 ]

numberFormat

Gibt die Zahlenformatzeichenfolge zurück, die zum Anzeigen dieses Werts verwendet wird. Beim Zugriff über eine valuesAsJson Eigenschaft befindet sich diese Zahlenformatzeichenfolge im Gebietsschema en-US. Beim Zugriff über eine valuesAsJsonLocal Eigenschaft befindet sich dieses Zahlenformat im Anzeigegebietsschema des Benutzers. Zahlenformatzeichenfolgen müssen den Excel-Richtlinien entsprechen. Weitere Informationen finden Sie unter Überprüfen von 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 double-Werts 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 Karte Ansicht verwendet werden.

provider?: CellValueProviderAttributes;

Eigenschaftswert

Excel.CellValueProviderAttributes

Hinweise

[ API-Satz: ExcelApi 1.19 ]

referencedValues

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

referencedValues?: ReferencedValue[];

Eigenschaftswert

Excel.ReferencedValue[]

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