ExcelScript.DatetimeFormatInfo interface

包:

ExcelScript

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

注解

示例

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

方法

getDateSeparator()	获取用作日期分隔符的字符串。 这基于当前的系统设置。
getLongDatePattern()	获取长日期值的格式字符串。 这基于当前的系统设置。
getLongTimePattern()	获取长时间值的格式字符串。 这基于当前的系统设置。
getShortDatePattern()	获取短日期值的格式字符串。 这基于当前的系统设置。
getTimeSeparator()	获取用作时间分隔符的字符串。 这基于当前的系统设置。

方法详细信息

getDateSeparator()

获取用作日期分隔符的字符串。 这基于当前的系统设置。

getDateSeparator(): string;

返回

string

示例

/**
 * This script writes the current date, month, and year.
 * It uses the system's date separator character.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first cell in the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Get the date separation string.
  const cultureInfo = workbook.getApplication().getCultureInfo();
  const systemDateTimeFormat = cultureInfo.getDatetimeFormat();
  const separator = systemDateTimeFormat.getDateSeparator();

  // Get the current date.
  const currentDate = new Date(Date.now());

  // Write the date using the system's separator character.
  cell.setValue(`${currentDate.getMonth()}${separator}${currentDate.getDate()}${separator}${currentDate.getFullYear()}`);
}

getLongDatePattern()

获取长日期值的格式字符串。 这基于当前的系统设置。

getLongDatePattern(): string;

返回

string

示例

/**
 * This script returns the system's long date pattern. 
 * This could be used in a Power Automate flow to keep date formatting consistent.
 */
function main(workbook: ExcelScript.Workbook) : string {
    const cultureInfo = workbook.getApplication().getCultureInfo();
    const dateTimeInfo =  cultureInfo.getDatetimeFormat();
    
    return dateTimeInfo.getLongDatePattern();
}

getLongTimePattern()

获取长时间值的格式字符串。 这基于当前的系统设置。

getLongTimePattern(): string;

返回

string

getShortDatePattern()

获取短日期值的格式字符串。 这基于当前的系统设置。

getShortDatePattern(): string;

返回

string

getTimeSeparator()

获取用作时间分隔符的字符串。 这基于当前的系统设置。

getTimeSeparator(): string;

返回

string

示例

/**
 * This script writes the current hour, minute, and second.
 * It uses the system's time separator character.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first cell in the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0, 0);

  // Get the date separation string.
  const cultureInfo = workbook.getApplication().getCultureInfo();
  const systemDateTimeFormat = cultureInfo.getDatetimeFormat();
  const separator = systemDateTimeFormat.getTimeSeparator();

  // Get the current time.
  const currentTime = new Date(Date.now());

  // Write the date using the system's separator character.
  cell.setValue(`${currentTime.getHours()}${separator}${currentTime.getMinutes()}${separator}${currentTime.getSeconds()}`);
}