ExcelScript.CultureInfo interface

提供基于当前系统区域性设置的信息。 这包括区域性名称、数字格式和其他区域性相关设置。

注解

示例

/**
 * This script sets the value of a cell to a date string for January 2, 2023.
 * It writes the day or month first in the string based on system settings.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first cell in the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Get the date format.
  const cultureInfo : ExcelScript.CultureInfo = workbook.getApplication().getCultureInfo();
  const systemDateTimeFormat : ExcelScript.DatetimeFormatInfo = cultureInfo.getDatetimeFormat();
  const shortDatePattern : string = systemDateTimeFormat.getShortDatePattern();

  // Determine if the date should start with the month or day.
  if (shortDatePattern.startsWith("m")) {
    cell.setValue("1/2/2023");
  } else {
    cell.setValue("2/1/2023");
  }
}

方法

getDatetimeFormat()

定义显示日期和时间在区域性上合适的格式。 这基于当前的系统区域性设置。

getName()

获取格式为 languagecode2-country/regioncode2 (的区域性名称,例如“zh-cn”或“en-us”) 。 这基于当前的系统设置。

getNumberFormat()

定义显示数字在区域性上合适的格式。 这基于当前的系统区域性设置。

方法详细信息

getDatetimeFormat()

定义显示日期和时间在区域性上合适的格式。 这基于当前的系统区域性设置。

getDatetimeFormat(): DatetimeFormatInfo;

返回

getName()

获取格式为 languagecode2-country/regioncode2 (的区域性名称,例如“zh-cn”或“en-us”) 。 这基于当前的系统设置。

getName(): string;

返回

string

getNumberFormat()

定义显示数字在区域性上合适的格式。 这基于当前的系统区域性设置。

getNumberFormat(): NumberFormatInfo;

返回