Excel.DoubleCellValue interface

Пакет:

excel

Представляет значение ячейки, содержащей двойную ячейку.

Комментарии

Набор API: ExcelApi 1.16

Свойства

basicType	Представляет значение, которое будет возвращено для ячейки Range.valueTypes с этим значением.
basicValue	Представляет значение, которое будет возвращено для ячейки Range.values с этим значением.
layouts	Представляет сведения макета для представлений с двойным значением.
numberFormat	Возвращает строку числового формата, которая используется для отображения этого значения. При доступе через свойство valuesAsJson эта строка числового формата имеет языковой стандарт en-US. При доступе через valuesAsJsonLocal свойство этот числовой формат соответствует языковому стандарту отображения, выбранному пользователем. Строки числового формата должны соответствовать рекомендациям Excel. Дополнительные сведения см. в статье Рекомендации по настройке числового формата.
properties	Представляет дополнительные свойства значения double
provider	Представляет сведения, описывающие службу, предоставившую данные в этом DoubleCellValueфайле. Эти сведения можно использовать для фирменной символики в представлении карт.
referencedValues	Представляет значения ячеек, на которые ссылается .DoubleCellValue.properties
type	Представляет тип значения ячейки.

Сведения о свойстве

basicType

Представляет значение, которое будет возвращено для ячейки Range.valueTypes с этим значением.

basicType?: RangeValueType.double | "Double";

Значение свойства

double | "Double"

Комментарии

Набор API: ExcelApi 1.16

basicValue

Представляет значение, которое будет возвращено для ячейки Range.values с этим значением.

basicValue: number;

Значение свойства

number

Комментарии

Набор API: ExcelApi 1.16

layouts

Представляет сведения макета для представлений с двойным значением.

layouts?: BasicViewLayouts;

Значение свойства

Excel.BasicViewLayouts

Комментарии

Набор API: ExcelApi 1.19

numberFormat

Возвращает строку числового формата, которая используется для отображения этого значения. При доступе через свойство valuesAsJson эта строка числового формата имеет языковой стандарт en-US. При доступе через valuesAsJsonLocal свойство этот числовой формат соответствует языковому стандарту отображения, выбранному пользователем. Строки числового формата должны соответствовать рекомендациям Excel. Дополнительные сведения см. в статье Рекомендации по настройке числового формата.

numberFormat?: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.19

Примеры

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

Представляет дополнительные свойства значения double

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

Значение свойства

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

Комментарии

Набор API: ExcelApi 1.19

provider

Представляет сведения, описывающие службу, предоставившую данные в этом DoubleCellValueфайле. Эти сведения можно использовать для фирменной символики в представлении карт.

provider?: CellValueProviderAttributes;

Значение свойства

Excel.CellValueProviderAttributes

Комментарии

Набор API: ExcelApi 1.19

referencedValues

Представляет значения ячеек, на которые ссылается .DoubleCellValue.properties

referencedValues?: ReferencedValue[];

Значение свойства

Excel.ReferencedValue[]

Комментарии

Набор API: ExcelApi 1.19

type

Представляет тип значения ячейки.

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

Значение свойства

double | double | "Double"

Комментарии

Набор API: ExcelApi 1.16

Примеры

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