Поделиться через


Excel.DoubleCellValue interface

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

Комментарии

[ Набор API: ExcelApi 1.16 ]

Свойства

basicType

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

basicValue

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

layouts

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

numberFormat

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

properties

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

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;

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

Комментарии

[ Набор 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

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

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

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

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

Комментарии

[ Набор API: ExcelApi 1.19 ]

provider

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

provider?: CellValueProviderAttributes;

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

Комментарии

[ Набор API: ExcelApi 1.19 ]

referencedValues

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

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