ExcelScript.DatetimeFormatInfo interface

Paket:

ExcelScript

Definiert das kulturell geeignete Format der Anzeige von Zahlen. Dies basiert auf den aktuellen Systemkultureinstellungen.

Hinweise

Beispiele

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

Methoden

getDateSeparator()	Ruft die Zeichenfolge ab, die als Datumstrennzeichen verwendet wird. Dies basiert auf den aktuellen Systemeinstellungen.
getLongDatePattern()	Ruft die Formatzeichenfolge für einen langen Datumswert ab. Dies basiert auf den aktuellen Systemeinstellungen.
getLongTimePattern()	Ruft die Formatzeichenfolge für einen langen Zeitwert ab. Dies basiert auf den aktuellen Systemeinstellungen.
getShortDatePattern()	Ruft die Formatzeichenfolge für einen kurzen Datumswert ab. Dies basiert auf den aktuellen Systemeinstellungen.
getTimeSeparator()	Ruft die Zeichenfolge ab, die als Zeittrennzeichen verwendet wird. Dies basiert auf den aktuellen Systemeinstellungen.

Details zur Methode

getDateSeparator()

Ruft die Zeichenfolge ab, die als Datumstrennzeichen verwendet wird. Dies basiert auf den aktuellen Systemeinstellungen.

getDateSeparator(): string;

Gibt zurück

string

Beispiele

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

Ruft die Formatzeichenfolge für einen langen Datumswert ab. Dies basiert auf den aktuellen Systemeinstellungen.

getLongDatePattern(): string;

Gibt zurück

string

Beispiele

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

Ruft die Formatzeichenfolge für einen langen Zeitwert ab. Dies basiert auf den aktuellen Systemeinstellungen.

getLongTimePattern(): string;

Gibt zurück

string

getShortDatePattern()

Ruft die Formatzeichenfolge für einen kurzen Datumswert ab. Dies basiert auf den aktuellen Systemeinstellungen.

getShortDatePattern(): string;

Gibt zurück

string

getTimeSeparator()

Ruft die Zeichenfolge ab, die als Zeittrennzeichen verwendet wird. Dies basiert auf den aktuellen Systemeinstellungen.

getTimeSeparator(): string;

Gibt zurück

string

Beispiele

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