Compartilhar via

Excel.DoubleCellValue interface

Pacote:
excel

Representa o valor de uma célula que contém um duplo.

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

Propriedades

basicType

Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue

Representa o valor que seria devolvido por para Range.values uma célula com este valor.
layouts

Representa informações de esquema para vistas deste valor duplo.
numberFormat

Devolve a cadeia de formato de número que é utilizada para apresentar este valor. Quando acedido através de uma valuesAsJson propriedade, esta cadeia de formato de número encontra-se na região en-US. Quando acedido através de uma valuesAsJsonLocal propriedade, este formato de número encontra-se na região de apresentação do utilizador. As cadeias de formato de número têm de estar em conformidade com as diretrizes do Excel. Para saber mais, veja Rever diretrizes para personalizar um formato de número.
properties

Representa propriedades adicionais deste valor duplo.
provider

Representa informações que descrevem o serviço que forneceu os dados neste DoubleCellValue. Estas informações podem ser utilizadas para imagem corporativa na vista card.
referencedValues

Representa os valores das células que são referenciados em DoubleCellValue.properties.
type

Representa o tipo deste valor de célula.

Detalhes da propriedade

basicType

Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.

basicType?: RangeValueType.double | "Double";

Valor da propriedade

double | "Double"

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

basicValue

Representa o valor que seria devolvido por para Range.values uma célula com este valor.

basicValue: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

layouts

Representa informações de esquema para vistas deste valor duplo.

layouts?: BasicViewLayouts;

Valor da propriedade

Excel.BasicViewLayouts

Comentários

[ Conjunto de API: ExcelApi 1.19 ]

numberFormat

Devolve a cadeia de formato de número que é utilizada para apresentar este valor. Quando acedido através de uma valuesAsJson propriedade, esta cadeia de formato de número encontra-se na região en-US. Quando acedido através de uma valuesAsJsonLocal propriedade, este formato de número encontra-se na região de apresentação do utilizador. As cadeias de formato de número têm de estar em conformidade com as diretrizes do Excel. Para saber mais, veja Rever diretrizes para personalizar um formato de número.

numberFormat?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.19 ]

Exemplos

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

Representa propriedades adicionais deste valor duplo.

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

Valor da propriedade

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

Comentários

[ Conjunto de API: ExcelApi 1.19 ]

provider

Representa informações que descrevem o serviço que forneceu os dados neste DoubleCellValue. Estas informações podem ser utilizadas para imagem corporativa na vista card.

provider?: CellValueProviderAttributes;

Valor da propriedade

Excel.CellValueProviderAttributes

Comentários

[ Conjunto de API: ExcelApi 1.19 ]

referencedValues

Representa os valores das células que são referenciados em DoubleCellValue.properties.

referencedValues?: ReferencedValue[];

Valor da propriedade

Excel.ReferencedValue[]

Comentários

[ Conjunto de API: ExcelApi 1.19 ]

type

Representa o tipo deste valor de célula.

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

Valor da propriedade

double | double | "Double"

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

Exemplos

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