ExcelScript.DatetimeFormatInfo interface
Define el formato culturalmente adecuado para mostrar números. Esto se basa en la configuración actual de la referencia cultural del sistema.
/**
* 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");
}
}
get |
Obtiene la cadena usada como separador de fecha. Esto se basa en la configuración actual del sistema. |
get |
Obtiene la cadena de formato para un valor de fecha larga. Esto se basa en la configuración actual del sistema. |
get |
Obtiene la cadena de formato para un valor de largo tiempo. Esto se basa en la configuración actual del sistema. |
get |
Obtiene la cadena de formato para un valor de fecha corto. Esto se basa en la configuración actual del sistema. |
get |
Obtiene la cadena usada como separador de tiempo. Esto se basa en la configuración actual del sistema. |
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()}`);
}
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();
}
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
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
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()}`);
}
Comentarios de Office Scripts
Office Scripts es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: