ExcelScript.DatetimeFormatInfo interface

Paquete:

ExcelScript

Define el formato culturalmente adecuado para mostrar números. Esto se basa en la configuración actual de la referencia cultural del sistema.

Comentarios

Ejemplos

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

Métodos

getDateSeparator()	Obtiene la cadena usada como separador de fecha. Esto se basa en la configuración actual del sistema.
getLongDatePattern()	Obtiene la cadena de formato para un valor de fecha larga. Esto se basa en la configuración actual del sistema.
getLongTimePattern()	Obtiene la cadena de formato para un valor de largo tiempo. Esto se basa en la configuración actual del sistema.
getShortDatePattern()	Obtiene la cadena de formato para un valor de fecha corto. Esto se basa en la configuración actual del sistema.
getTimeSeparator()	Obtiene la cadena usada como separador de tiempo. Esto se basa en la configuración actual del sistema.

Detalles del método

getDateSeparator()

Obtiene la cadena usada como separador de fecha. Esto se basa en la configuración actual del sistema.

getDateSeparator(): string;

Devoluciones

string

Ejemplos

/**
 * 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()

Obtiene la cadena de formato para un valor de fecha larga. Esto se basa en la configuración actual del sistema.

getLongDatePattern(): string;

Devoluciones

string

Ejemplos

/**
 * 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()

Obtiene la cadena de formato para un valor de largo tiempo. Esto se basa en la configuración actual del sistema.

getLongTimePattern(): string;

Devoluciones

string

getShortDatePattern()

Obtiene la cadena de formato para un valor de fecha corto. Esto se basa en la configuración actual del sistema.

getShortDatePattern(): string;

Devoluciones

string

getTimeSeparator()

Obtiene la cadena usada como separador de tiempo. Esto se basa en la configuración actual del sistema.

getTimeSeparator(): string;

Devoluciones

string

Ejemplos

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