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


Excel.FormattedNumberCellValue interface

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

Комментарии

[ Набор API: ExcelApi 1.16 ]

Свойства

basicType

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

basicValue

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

numberFormat

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

type

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

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

basicType

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

basicType?: RangeValueType.double | "Double";

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

double | "Double"

Комментарии

[ Набор API: ExcelApi 1.16 ]

basicValue

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

basicValue: number;

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

number

Комментарии

[ Набор API: ExcelApi 1.16 ]

numberFormat

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

numberFormat: string;

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

string

Комментарии

[ Набор 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 formatted number 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.formattedNumber,
        basicValue: 12.34,
        numberFormat: "$* #,##0.00"
      }
    ]
  ];

  await context.sync();
});

type

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

type: CellValueType.formattedNumber | "FormattedNumber";

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

formattedNumber | "FormattedNumber"

Комментарии

[ Набор 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 formatted number 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.formattedNumber,
        basicValue: 32889.0,
        numberFormat: "m/d/yyyy"
      }
    ]
  ];
  await context.sync();
});